共用方式為

SetupDiBuildClassInfoListExA 函式 （setupapi.h）

  • 發行項

SetupDiBuildClassInfoListEx 函式會傳回安裝類別 GUID 的清單，其中包含安裝在本機系統或遠端系統上的每個類別。

語法

WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

參數

[in] Flags

用來控制清單中類別排除的旗標。 如果未指定旗標，則清單中會包含所有設定類別。 可以是下列值的組合：

DIBCI_NOINSTALLCLASS

如果類別在其登錄機碼中有 NoInstallClass 值專案，請排除類別。

DIBCI_NODISPLAYCLASS

如果類別在其登錄機碼中有 NoDisplayClass 值專案，請排除類別。

[out, optional] ClassGuidList

接收安裝類別 GUID 清單之緩衝區的指標。

[in] ClassGuidListSize

提供 ClassGuildList 陣列中的 GUID 數目。

[out] RequiredSize

接收傳回之 GUID 數目的變數指標。 如果這個數位大於 ClassGuidList的大小，則此數位會指出 ClassGuidList 數位的大小，才能包含清單。

[in, optional] MachineName

NULL 終止字串的指標，其中包含要從中擷取已安裝之安裝類別之遠端電腦的名稱。 這個參數是選擇性的，而且可以 NULL。 如果 MachineName 為 NULL，則此函式會建置本機電腦上安裝的類別清單。

謹慎

從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為此功能已移除。

Reserved

必須 NULL。

傳回值

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

言論

注意

setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupDiBuildClassInfoListEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Microsoft Windows 2000 和更新版本的 Windows 中提供。
目標平臺 桌面
標頭 setupapi.h （包括 Setupapi.h）
連結庫 Setupapi.lib

另請參閱

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx