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 |