función ImageList_CoCreateInstance (commoncontrols.h)

Crea una única instancia de una lista de imágenes y devuelve un puntero de interfaz a ella.

Sintaxis

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

Parámetros

[in] rclsid

Tipo: REFCLSID

Referencia al CLSID: un GUID que identifica el objeto COM que se va a crear. Debe ser CLSID_ImageList.

[in, optional] punkOuter

Tipo: const IUnknown*

Puntero a la interfaz IUnknown externa que agrega el objeto creado por esta función o NULL si no se desea ninguna agregación.

[in] riid

Tipo: REFIID

Referencia al identificador de interfaz deseado.

[out] ppv

Tipo: void**

Cuando este método devuelve, contiene el puntero de interfaz solicitado en riid. Normalmente, es IImageList2, que proporciona el método Initialize .

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Antes de llamar a esta función, COM debe inicializarse llamando a CoInitialize o CoInitializeEx.

Llame a ImageList_CoCreateInstance para obtener una lista de imágenes personalizada; De lo contrario, llame a SHGetImageList para cargar la lista de imágenes del sistema. Llame a SHGetFileInfo con el parámetro uflag establecido en SHGFI_SYSICONINDEX para recuperar un identificador en la lista de imágenes del sistema.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commoncontrols.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll