SetupDiBuildClassInfoListExA 函式 (setupapi.h)

發行項
03/01/2024

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

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台	桌面
標頭	setupapi.h (包括 Setupapi.h)
程式庫	Setupapi.lib

另請參閱

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

Share via