Функция ExtractAssociatedIconExA (shellapi.h)
[ExtractAssociatedIconEx доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]
Возвращает дескриптор значка, хранящегося в виде ресурса в файле или значке, хранящееся в связанном исполняемом файле файла. Он расширяет функцию ExtractAssociatedIcon путем получения идентификатора значка при извлечении этого значка из исполняемого файла.
Синтаксис
HICON ExtractAssociatedIconExA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIconIndex,
[in, out] WORD *piIconId
);
Параметры
[in] hInst
Тип: HINSTANCE
Дескриптор модуля, из которого извлекается значок.
[in, out] pszIconPath
Тип: LPTSTR
Указатель на строку, которая в записи указывает полный путь и имя файла, содержащего значок. Функция извлекает дескриптор значка из этого файла или из исполняемого файла, связанного с этим файлом.
Когда эта функция возвращается, если дескриптор значка был получен из исполняемого файла (исполняемый файл, непосредственно указывающий на этот параметр или связанный исполняемый файл), функция сохраняет полный путь и имя файла этого исполняемого файла в буфере, на который указывает этот параметр.
[in, out] piIconIndex
Тип: LPWORD
Указатель на значение WORD, указывающее индекс значка, дескриптор которого требуется получить.
Когда функция возвращается, если дескриптор значка был получен из исполняемого файла (исполняемый файл, на который указывает lpIconPath или связанный исполняемый файл), это значение указывает на индекс значка в этом файле.
[in, out] piIconId
Тип: LPWORD
Указатель на значение WORD, указывающее идентификатор значка, который должен быть получен дескриптором.
Когда функция возвращается, если дескриптор значка был получен из исполняемого файла (исполняемый файл, на который указывает lpIconPath или связанный исполняемый файл), это значение указывает на идентификатор значка в этом файле.
Возвращаемое значение
Тип: HICON
Возвращает дескриптор значка в случае успешного выполнения, в противном случае значение NULL.
Замечания
Дескриптор значка, возвращаемый этой функцией, должен быть освобожден путем вызова DestroyIcon, когда он больше не нужен.
Заметка
Заголовок shellapi.h определяет ExtractAssociatedIconEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | shellapi.h |
| библиотеки |
Shell32.lib |
| DLL | Shell32.dll (версия 5.0 или более поздняя версия) |