Функция 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 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shellapi.h |
| DLL | Shell32.dll |
| Набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |