Функция SHCreateFileExtractIconA (shlobj_core.h)

[SHCreateFileExtractIcon доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Создает обработчик IExtractIcon по умолчанию для объекта файловой системы. Расширения пространства имен, отображающие объекты файловой системы, обычно используют эту функцию. Атрибуты расширения и файла являются производными от всего, что необходимо для простого средства извлечения значков.

Синтаксис

SHSTDAPI SHCreateFileExtractIconA(
  [in] LPCSTR pszFile,
  [in] DWORD  dwFileAttributes,
  [in] REFIID riid,
       void   **ppv
);

Параметры

[in] pszFile

Тип: LPCTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает объект файловой системы. Длина буфера не должна превышать MAX_PATH символов.

[in] dwFileAttributes

Тип: DWORD

Сочетание одного или нескольких флагов атрибутов файла (FILE_ATTRIBUTE_* значений, определенных в Winnt.h), которые указывают тип объекта.

[in] riid

Тип: REFIID

Ссылка на требуемый идентификатор интерфейса создаваемого интерфейса средства извлечения значков. Это должно быть либо IID_IExtractIconA, либо IID_IExtractIconW.

ppv

Тип: void**

При возврате этой функции содержит указатель интерфейса, запрошенный в riid. Обычно это IExtractIcon.

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

Тип: HRESULT

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

Требования

Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)