Compartilhar via

Função ImageList_CoCreateInstance (commoncontrols.h)

  • Artigo

Cria uma única instância de uma lista de imagens e retorna um ponteiro de interface para ela.

Sintaxe

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

Parâmetros

[in] rclsid

Tipo: REFCLSID

Uma referência ao CLSID — um GUID que identifica o objeto COM a ser criado. Isso deve ser CLSID_ImageList.

[in, optional] punkOuter

Tipo: const IUnknown*

Um ponteiro para a interface IUnknown externa que agrega o objeto criado por essa função ou NULL se nenhuma agregação for desejada.

[in] riid

Tipo: REFIID

Referência à ID da interface desejada.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IImageList2, que fornece o método Initialize .

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Antes de chamar essa função, COM deve ser inicializado chamando CoInitialize ou CoInitializeEx.

Chamar ImageList_CoCreateInstance para uma lista de imagens personalizadas; caso contrário, chame SHGetImageList para carregar a lista de imagens do sistema. Chame SHGetFileInfo com o parâmetro uflag definido como SHGFI_SYSICONINDEX para recuperar um identificador para a lista de imagens do sistema.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commoncontrols.h
Biblioteca Comctl32.lib
DLL Comctl32.dll