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

另請參閱

SetupDiGetClassImageList

SetupDiGetClassImageListEx