共用方式為


SetupDiGetClassImageList 函式 (setupapi.h)

SetupDiGetClassImageList 函式會建置映射清單,其中包含每個已安裝類別的位圖,並傳回數據結構中的清單。

語法

WINSETUPAPI BOOL SetupDiGetClassImageList(
  [out] PSP_CLASSIMAGELIST_DATA ClassImageListData
);

參數

[out] ClassImageListData

要接收類別影像清單相關信息之 SP_CLASSIMAGELIST_DATA 結構的指標,包括影像清單的句柄。 此結構的 cbSize 字段必須以結構的大小初始化,以位元組為單位,再呼叫此函式,否則將會失敗。

傳回值

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

備註

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

呼叫 SetupDiGetClassImageListEx 以擷取遠端電腦上安裝之類別的映像清單。

規格需求

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

另請參閱

SetupDiDestroyClassImageList

SetupDiGetClassImageListEx