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

Статья
08/26/2023

[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.

Заголовок shellapi.h определяет ExtractAssociatedIconEx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shellapi.h
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя)

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

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx

Share via