SetupDiGetClassImageListExA 函式 (setupapi.h)

SetupDiGetClassImageListEx函式會針對安裝在本機或遠端系統上的每個類別建置點陣圖影像清單。

語法

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   MachineName,
                 PVOID                   Reserved
);

參數

[out] ClassImageListData

SP_CLASSIMAGELIST_DATA 結構的指標 ,可接收類別影像清單的相關資訊,包括影像清單的控制碼。 此結構的 cbSize 欄位必須以結構的大小初始化,以位元組為單位,再呼叫此函式,否則會失敗。

[in, optional] MachineName

Null 終止字串的指標,其類別 SetupDiGetClassImageListEx 必須建置 點陣圖的遠端系統名稱。 此參數是選擇性的,可以是 Null。 如果 MachineNameNullSetupDiGetClassImageListEx 會建置本機系統的清單。

Reserved

必須是 Null

傳回值

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

備註

呼叫 SetupDiDestroyClassImageList,應該終結此函式所建置的映射清單。

注意 只有在類別也存在於本機電腦上時,才能顯示遠端電腦上的類別特定圖示。 因此,如果遠端電腦有 類別 X,但類別 X 未安裝在本機,則會傳回泛型 (未知) 圖示。
 

注意

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

規格需求

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

另請參閱

SetupDiDestroyClassImageList

SetupDiGetClassImageList