通过

CM_Get_HW_Prof_FlagsA函数 （cfgmgr32.h）

  • 项目

[从 Windows 8 和 Windows Server 2012 开始，此函数已被弃用，不应使用。

CM_Get_HW_Prof_Flags 函数检索本地计算机上 设备实例特定配置标志 硬件配置文件。

语法

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
  [in]  DEVINSTID_A pDeviceID,
  [in]  ULONG       ulHardwareProfile,
  [out] PULONG      pulValue,
  [in]  ULONG       ulFlags
);

参数

[in] pDeviceID

指向 NULL 终止的字符串的指针，该字符串包含要为其检索特定于硬件配置文件的配置标志的设备 设备实例 ID。

[in] ulHardwareProfile

ULONG 类型的变量，指定要为其检索配置标志的硬件配置文件的标识符。 如果此参数为零，则此函数检索当前硬件配置文件的配置标志。

[out] pulValue

指向 ULONG 类型的调用方提供的变量的指针，该变量接收 Regstr.h中定义的以下配置标志的零个或按位 OR：

CSCONFIGFLAG_BITS

其他CSCONFIGFLAG_Xxx标志的按位 OR。

CSCONFIGFLAG_DISABLE

在指定的硬件配置文件中禁用设备实例。

CSCONFIGFLAG_DO_NOT_CREATE

硬件配置文件不支持指定的设备实例。

CSCONFIGFLAG_DO_NOT_START

设备不能在指定的硬件配置文件中启动。

[in] ulFlags

保留供内部使用。 必须设置为零。

返回值

如果操作成功，CM_Get_HW_Prof_Flags 返回CR_SUCCESS。 否则，该函数将返回 Cfgmgr32.h中定义的 CR_Xxx 错误代码之一。

言论

若要检索当前在本地计算机上定义的硬件配置文件 ID 列表，请调用 SetupDiGetHwProfileList。

若要检索远程计算机上的设备实例的配置标志，请调用 CM_Get_HW_Prof_Flags_Ex。

注意

cfgmgr32.h 标头将CM_Get_HW_Prof_Flags定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 cfgmgr32.h （包括 Cfgmgr32.h）
库 Cfgmgr32.lib

另请参阅

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList