SetupDiGetHwProfileList 函数 (setupapi.h)

  • 项目

SetupDiGetHwProfileList 函数检索当前定义的所有硬件配置文件 ID 的列表。

语法

WINSETUPAPI BOOL SetupDiGetHwProfileList(
  [out]           PDWORD HwProfileList,
  [in]            DWORD  HwProfileListSize,
  [out]           PDWORD RequiredSize,
  [out, optional] PDWORD CurrentlyActiveIndex
);

参数

[out] HwProfileList

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

[in] HwProfileListSize

HwProfileList 缓冲区中的 DWORD 数。

[out] RequiredSize

指向 DWORD 类型的变量的指针，该变量接收当前定义的硬件配置文件的数量。 如果数字大于 HwProfileListSize，则列表将被截断以适应数组大小。 RequiredSize 中返回的值指示存储整个硬件配置文件列表所需的数组大小。 在这种情况下， 函数失败，对 GetLastError 的调用将返回ERROR_INSUFFICIENT_BUFFER。

[out, optional] CurrentlyActiveIndex

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

返回值

如果成功，函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

调用 SetupDiGetHwProfileListEx 以检索远程计算机的硬件配置文件 ID。

要求

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

另请参阅

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey