Функция 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 , когда он больше не нужен.

Требования

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

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx