通过

CM_Get_HW_Prof_Flags_ExW函数 （cfgmgr32.h）

  • 项目

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

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

语法

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExW(
  [in]           DEVINSTID_W 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）
库 Cfgmgr32.lib

另请参阅

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx