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