Поделиться через


функция ImageList_CoCreateInstance (commoncontrols.h)

Создает один экземпляр списка изображений и возвращает указатель интерфейса на него.

Синтаксис

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

Ссылка на требуемый идентификатор интерфейса.

[out] ppv

Тип: void**

При возврате этого метода содержит указатель интерфейса, запрошенный в riid. Обычно это IImageList2, предоставляющий метод Initialize .

Возвращаемое значение

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Перед вызовом этой функции com необходимо инициализировать, вызвав CoInitialize или CoInitializeEx.

Вызовите ImageList_CoCreateInstance для настраиваемого списка изображений; В противном случае вызовите SHGetImageList, чтобы загрузить список образов системы. Вызовите SHGetFileInfo с параметром uflag , для которого задано значение SHGFI_SYSICONINDEX , чтобы получить дескриптор списка образов системы.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header commoncontrols.h
Библиотека Comctl32.lib
DLL Comctl32.dll