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 参数中返回 Unknown 设备安装程序类的图像索引。

要求

要求
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

SetupDiGetClassImageList

SetupDiGetClassImageListEx