SetupDiGetClassImageIndex 函式 (setupapi.h)
SetupDiGetClassImageIndex 函式會擷取指定類別之類別影像清單中的索引。
語法
WINSETUPAPI BOOL SetupDiGetClassImageIndex(
[in] PSP_CLASSIMAGELIST_DATA ClassImageListData,
[in] const GUID *ClassGuid,
[out] PINT ImageIndex
);
參數
[in] ClassImageListData
SP_CLASSIMAGELIST_DATA 結構的指標,描述類別映射清單,其中包含 ClassGuid 參數所指定之裝置安裝類別的影像。
[in] ClassGuid
要擷取指定類別映像清單中類別影像索引之裝置安裝類別之 GUID 的指標。
[out] ImageIndex
INT 型別變數的指標,可接收類別影像清單中指定類別影像的索引。
傳回值
如果函式成功,函式會傳回 TRUE 。 否則,它會傳回 FALSE ,而且可以透過 呼叫 GetLastError 來擷取記錄的錯誤。
備註
如果指定的裝置安裝類別未包含在指定的類別映像清單中, SetupDiGetClassImageIndex 會傳回 ImageIndex 參數中未知裝置安裝類別的影像索引。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | setupapi.h (包括 Setupapi.h) |
程式庫 | Setupapi.lib |
Dll | Setupapi.dll |