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)
Library	Cfgmgr32.lib

另请参阅

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList