SetupDiGetHwProfileList 函式 (setupapi.h)

SetupDiGetHwProfileList 函式會擷取所有目前定義硬體配置檔標識符的清單。

語法

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

參數

[out] HwProfileList

陣列的指標，用來接收目前定義的硬體配置檔識別符清單。

[in] HwProfileListSize

HwProfileList 緩衝區中的 DWORD 數目。

[out] RequiredSize

DWORD 類型的變數指標，可接收目前定義的硬體配置檔數目。 如果數位大於 HwProfileListSize，則會截斷清單以符合數位大小。 RequiredSize 中傳回的值表示儲存整個硬體配置檔清單所需的數位大小。 在此情況下，函式會失敗，而且 呼叫 GetLastError 會傳回ERROR_INSUFFICIENT_BUFFER。

[out, optional] CurrentlyActiveIndex

DWORD 類型的變數指標，該變數會接收所擷取之硬體配置檔清單中目前作用中硬體配置檔的索引。 這個參數是選擇性的，而且可以是 NULL。

傳回值

如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以藉由呼叫 GetLastError 來擷取記錄的錯誤。

備註

呼叫 SetupDiGetHwProfileListEx 以擷取遠端電腦的硬體配置文件識別碼。

規格需求

另請參閱

SetupDiCreateDevRegKey

SetupDiOpenDevRegKey