Функция ExtractIconA (shellapi.h)
Возвращает дескриптор значка из указанного исполняемого файла, DLL или файла значка.
Чтобы получить массив дескрипторов для больших или небольших значков, используйте функцию ExtractIconEx.
Синтаксис
HICON ExtractIconA(
[in] HINSTANCE hInst,
[in] LPCSTR pszExeFileName,
UINT nIconIndex
);
Параметры
[in] hInst
Тип: HINSTANCE
Обработка экземпляра приложения, вызывающего функцию.
[in] pszExeFileName
Тип: LPCTSTR
Указатель на строку, завершающуюся значением NULL, которая указывает имя исполняемого файла, dll или файла значка.
nIconIndex
Тип: UINT
Указывает отсчитываемый от нуля индекс извлекаемого значка. Например, если это значение равно 0, функция возвращает дескриптор первому значку в указанном файле.
Если это значение равно -1, функция возвращает общее количество значков в указанном файле. Если файл является исполняемым файлом или библиотекой DLL, возвращаемое значение — это количество RT_GROUP_ICON ресурсов. Если файл является . ICO-файл, возвращаемое значение равно 1.
Если это значение не равно –1, функция возвращает дескриптор в указанном файле, идентификатор ресурса которого равен абсолютному значению nIconIndex. Например, необходимо использовать –3 для извлечения значка, идентификатор ресурса которого равен 3. Чтобы извлечь значок, идентификатор ресурса которого равен 1, используйте функцию ExtractIconEx.
Возвращаемое значение
Тип: HICON
Возвращаемое значение — это дескриптор значка. Если указанный файл не был исполняемым файлом, DLL или файлом значка, возвращается значение 1. Если в файле не найдены значки, возвращаемое значение NULL.
Замечания
Если он больше не нужен, необходимо уничтожить дескриптор значка, возвращенный ExtractIcon путем вызова функции DestroyIcon.
Заметка
Заголовок shellapi.h определяет ExtractIcon как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | shellapi.h |
| DLL | Shell32.dll |
| набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |