ImageList_CoCreateInstance 函数 (commoncontrols.h)

创建 imagelist 的单个实例，并返回指向它的接口指针。

语法

HRESULT ImageList_CoCreateInstance(
  [in]           REFCLSID       rclsid,
  [in, optional] const IUnknown *punkOuter,
  [in]           REFIID         riid,
  [out]          void           **ppv
);

参数

[in] rclsid

类型： REFCLSID

对 CLSID 的引用，该 GUID 标识要创建的 COM 对象。 这应该 CLSID_ImageList。

[in, optional] punkOuter

类型： const IUnknown*

指向聚合此函数创建的对象的外部 IUnknown 接口的指针;如果不需要聚合，则为 NULL 。

[in] riid

类型： REFIID

对所需接口 ID 的引用。

[out] ppv

类型： void**

此方法返回时，包含 riid 中请求的接口指针。 这通常是 IImageList2，它提供 Initialize 方法。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

备注

在调用此函数之前，必须通过调用 CoInitialize 或 CoInitializeEx 来初始化 COM。

调用 自定义 映像列表ImageList_CoCreateInstance;否则，请调用 SHGetImageList 以加载系统映像列表。 调用 SHGetFileInfo ，并将 uflag 参数设置为 SHGFI_SYSICONINDEX 以检索系统映像列表的句柄。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	commoncontrols.h
Library	Comctl32.lib
DLL	Comctl32.dll