通过

SetupDiGetHwProfileListExA 函数 （setupapi.h）

  • 项目

SetupDiGetHwProfileListEx 函数检索本地或远程计算机上当前定义的所有硬件配置文件 ID 的列表。

语法

WINSETUPAPI BOOL SetupDiGetHwProfileListExA(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

参数

[out] HwProfileList

指向数组的指针，用于接收当前定义的硬件配置文件 ID 的列表。

[in] HwProfileListSize

HwProfileList 缓冲区中的 DWORD 数。

[out] RequiredSize

指向类型为 DWORD 的变量的指针，该变量接收当前定义的硬件配置文件数。 如果数字大于 HwProfileListSize，则会截断列表以适应数组大小。 RequiredSize 中返回的值指示存储整个硬件配置文件列表所需的数组大小。

[out, optional] CurrentlyActiveIndex

指向一个变量的指针，该变量接收检索到的硬件配置文件列表中的当前活动硬件配置文件的索引。 此参数是可选的，可以 NULL。

[in, optional] MachineName

指向以 NULL 结尾的字符串的指针，其中包含要为其检索硬件配置文件 ID 列表的远程系统的名称。 此参数是可选的，可以 NULL。 如果此参数 NULL，则会为本地系统检索列表。

谨慎

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

Reserved

必须为 NULL。

返回值

如果函数成功，则返回 TRUE。 否则，它返回 FALSE，可以通过调用 getLastError来检索记录的错误。 如果所需的大小大于 HwProfileListSize，则 SetupDiGetHwProfileListEx 返回 FALSE， GetLastError 调用返回ERROR_INSUFFICIENT_BUFFER。

言论

注意

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

要求

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

另请参阅

SetupDiGetHwProfileFriendlyNameEx