CM_Get_HW_Prof_Flags_ExA 函数 (cfgmgr32.h)

  • 项目

[此函数已弃用，不应使用。]

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

语法

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
  [in]           DEVINSTID_A pDeviceID,
  [in]           ULONG       ulHardwareProfile,
  [out]          PULONG      pulValue,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

参数

[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

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

[in, optional] hMachine

通过调用 CM_Connect_Machine 或 NULL 返回的计算机句柄。 如果此参数设置为 NULL， CM_Get_HW_Prof_Flags_Ex 将检索本地计算机上的配置标志。

注意 从 Windows 8 和 Windows Server 2012 开始，不支持使用此函数访问远程计算机，因为此功能已被删除。
 

返回值

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

备注

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

Windows 8 和 Windows Server 2012 及更高版本的操作系统中删除了访问远程计算机的功能，因此在这些版本的 Windows 上运行时，无法访问远程计算机。

注意

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

要求

   
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Library Cfgmgr32.lib

另请参阅

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx