Функция ExtractAssociatedIconA (shellapi.h)

Статья
08/26/2023

Получает дескриптор значка, хранящегося в виде ресурса в файле, или значка, хранящегося в связанном исполняемом файле файла.

Синтаксис

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 сначала ищет индексированный значок в файле, указанном 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)

См. также раздел

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx

Share via