Функция ExtractIcon

Функция ExtractIcon извлекает дескриптор значка из указанного исполняемого файла, динамически подключаемой библиотеки (DLL) или файла значка.

Чтобы извлечь массив дескрипторов больших или маленьких значков, используйте функцию ExtractIconEx.

Синтаксис

Параметры

hInst

[in] Дескриптор экземпляра приложения, вызывающего функцию.

lpszExeFileName

[in] Указатель на строку с завершающим нулем, определяющую имя исполняемого файла, динамически подключаемой библиотеки (DLL) или файла значка.

nIconIndex

[in] Определяет отсчитываемый от нуля индекс извлекаемого значка. Например, если это значение равно 0, функция возвращает дескриптор первого значка в указанном файле.

Если это значение равно – (минус)1, функция возвращает общее количество значков в указанном файле. Если файл - это исполняемый файл или динамически подключаемая библиотека (DLL), возвращаемое значение - число ресурсов RT_GROUP_ICON. Если файл - .ICO файл, возвращаемое значение равно 1.

Windows 95/98/Me, Windows NT 4.0 и позже: Если это значение - отрицательное число, не равное - (минус)1, функция возвращает дескриптор значка в указанном файле, чей идентификатор ресурса равен абсолютному значению параметра nIconIndex. Например, используйте – (минус)3, чтобы извлечь значок, идентификатор ресурса которого равен 3. Чтобы извлечь значок, идентификатор ресурса которого равен 1, используйте функцию ExtractIconEx.

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

Возвращаемое значение - дескриптор значка. Если определенный файл не был исполняемым файлом, динамически подключаемой библиотекой (DLL) или файлом значка, возвращается 1. Если никакие значки не были найдены в файле, возвращаемое значение - NULL.

Замечания

Вы должны уничтожить дескриптор значка, возвращенный ExtractIcon при помощи вызова функции DestroyIcon.

Windows 95/98/Me: ExtractIconW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор Значки, Функции, используемые значками, DestroyIcon, ExtractIconEx