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

Метод IExtractIconA::Extract (shlobj_core.h)

  • Статья

Извлекает изображение значка из указанного расположения.

Синтаксис

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

Параметры

[in] pszFile

Тип: PCTSTR

Указатель на строку, завершающуюся значением NULL, которая указывает расположение значка.

nIconIndex

Тип: UINT

Индекс значка в файле, на который указывает pszFile.

[out, optional] phiconLarge

Тип: HICON*

Указатель на значение HICON , получающее дескриптор большого значка. Этот параметр может иметь значение NULL.

[out, optional] phiconSmall

Тип: HICON*

Указатель на значение HICON , которое получает дескриптор небольшого значка. Этот параметр может иметь значение NULL.

nIconSize

Тип: UINT

Требуемый размер значка в пикселях. Низкое слово содержит размер большого значка, а высокое слово — размер маленького значка. Указанный размер может быть шириной или высотой. Ширина значка всегда равна его высоте.

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

Тип: HRESULT

Возвращает S_OK, если функция извлекла значок, или S_FALSE, если вызывающее приложение должно извлечь значок.

Комментарии

Расположение значка и индекс — это одинаковые значения, возвращаемые методом IExtractIcon::GetIconLocation . Если функция IExtractIcon::Extract возвращает S_FALSE, эти значения должны указывать имя файла значка и индекс, которые формируют юридические параметры для вызова ExtractIcon. Если IExtractIcon::Extract не возвращает S_FALSE, не следует делать никаких предположений о значениях параметров pszFile и nIconIndex .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h
DLL Shell32.dll (версия 4.0 или более поздняя)

См. также раздел

IExtractIcon