Функция ExtractAssociatedIconA (shellapi.h)
Возвращает дескриптор значка, хранящегося в виде ресурса в файле или значке, хранящееся в связанном исполняемом файле файла.
Синтаксис
HICON ExtractAssociatedIconA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIcon
);
Параметры
[in] hInst
Тип: HINSTANCE
Дескриптор экземпляра вызывающего приложения.
[in, out] pszIconPath
Тип: LPTSTR
Указатель на строку, которая в записи указывает полный путь и имя файла, содержащего значок. Функция извлекает дескриптор значка из этого файла или из исполняемого файла, связанного с этим файлом.
Когда эта функция возвращается, если дескриптор значка был получен из исполняемого файла (исполняемый файл, на который указывает lpIconPath или связанный исполняемый файл), функция сохраняет полный путь и имя файла этого исполняемого файла в буфере, на который указывает этот параметр.
[in, out] piIcon
Тип: LPWORD
Указатель на значение WORD, указывающее индекс значка, дескриптор которого требуется получить.
Когда функция возвращается, если дескриптор значка был получен из исполняемого файла (исполняемый файл, на который указывает lpIconPath или связанный исполняемый файл), это значение указывает на индекс значка в этом файле.
Возвращаемое значение
Тип: HICON
Если функция выполнена успешно, возвращаемое значение является дескриптором значка. Если значок извлекается из связанного исполняемого файла, функция сохраняет полный путь и имя файла исполняемого файла в строке, на которую указывает lpIconPath, и сохраняет идентификатор значка в WORD, на который указывает lpiIcon.
Если функция завершается ошибкой, возвращаемое значение равно NULL.
Замечания
Если он больше не нужен, вызывающий объект отвечает за освобождение дескриптора значка, возвращенного ExtractAssociatedIcon путем вызова функции DestroyIcon.
Функция extractAssociatedIcon сначала ищет индексированный значок в файле, указанном lpIconPath. Если функция не может получить дескриптор значка из этого файла, а файл имеет связанный исполняемый файл, он выглядит в этом исполняемом файле для значка. Связи с исполняемыми файлами основаны на расширениях имен файлов и хранятся в части реестра для каждого пользователя.
Заметка
Заголовок shellapi.h определяет ExtractAssociatedIcon как псевдоним, который автоматически выбирает версию 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) |