SetupDiBuildClassInfoList 函式 (setupapi.h)
SetupDiBuildClassInfoList 函式會傳回設定類別 GUID 的清單，以識別安裝在本機電腦上的類別。
語法
WINSETUPAPI BOOL SetupDiBuildClassInfoList(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
參數
[in] Flags
用來控制清單中類別排除的旗標。 如果未指定旗標，所有安裝類別都會包含在清單中。 可以是下列值的組合：
DIBCI_NOINSTALLCLASS
如果類別在其登錄機碼中有 NoInstallClass 值專案，請排除類別。
DIBCI_NODISPLAYCLASS
如果類別在其登錄機碼中有 NoDisplayClass 值專案，請排除類別。
[out, optional] ClassGuidList
GUID 型別數位列的指標，可接收安裝類別 GUID 的清單。 此指標是選擇性的，可以是 NULL。
[in] ClassGuidListSize
ClassGuildList 參數所指向之陣列中的 GUID 數目。 如果 ClassGuidList 為 NULL，ClassGuidSize 必須為零。
[out] RequiredSize
DWORD 型別變數的指標，如果數位小於或等於 ClassGuidList 參數所指向之陣列的大小，則傳回的 GUID 數目會) (。
如果這個數位大於 ClassGuidList 陣列的大小，它會指出 ClassGuidList 陣列必須有多大，才能包含所有類別 GUID。
傳回值
如果函式成功，函式會傳回 TRUE 。 否則，它會傳回 FALSE ，而且可以藉由呼叫 GetLastError 來擷取記錄的錯誤。
備註
若要擷取安裝在本機計算機上的類別數目，請呼叫 SetupDiBuildClassInfoList ，並將 ClassGuidList 設定為 NULL ，而 ClassGuidSize 設定為零。 為了回應這類呼叫，函式會傳回 RequiredSize 中的*類別數目。
如果 NoUseClass 值專案存在於 類別的登錄機碼中，SetupDiBuildClassInfoList 不會傳回類別的類別 GUID。
若要擷取安裝在遠端系統上的安裝程序類別 GUID 清單，請使用 SetupDiBuildClassInfoListEx。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |