ExtractIcon

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

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

() HICON ExtractIcon HINSTANCE  hInst, / / экземпляра ручкиLPCTSTRlpszExeFileName, / / имя файла с иконойUINTnIconIndex / / индекс значка для извлечения);
 

Параметры

hInst
Дескриптор экземпляра приложения, вызова функции.
lpszExeFileName
Указатель на ограниченную значением null строку, определяющий имя исполняемого файла, DLL или файла значка.
nIconIndex
Указывает начинающийся с нуля индекс значка для извлечения. Например если это значение равно 0, функция возвращает дескриптор первая икона в указанном файле.

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

Windows 95, Windows NT 4.0 и более поздних: Если это значение является отрицательным числом, не равным -1, функция возвращает дескриптор для значка в указанном файле, чей идентификатор ресурса равно абсолютному значению nIconIndex. К примеру используйте для извлечения значка, чей идентификатор ресурса — 3 -3. Для значка, чей идентификатор ресурса равно 1, используйте функцию ExtractIconEx.

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

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

Примечания

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

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в shellapi.h.
Импорта библиотеки:Используйте shell32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор значки, значок функции, DestroyIcon, ExtractIconEx

Index