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)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

SetupDiDestroyClassImageList

SetupDiGetClassImageListEx