Функция ExtractAssociatedIcon

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

Синтаксис

HICON ExtractAssociatedIcon(

            HINSTANCE hInst,
            LPTSTR lpIconPath,
            LPWORD lpiIcon
);

Параметры

hInst

[in] Определяет экземпляр приложения, вызывающего функцию.

lpIconPath

[in] Указатель на строку, которая определяет полный путь и имя файла, содержащего в себе значок. Функция извлекает дескриптор значка из этого файла, или из исполняемого файла, связанного с этим файлом. Если дескриптор значка получается из исполняемого файла, функция хранит полный путь, а имя исполняемого файла, в строке указанной при помощи lpIconPath.

lpiIcon

[in, out] Указатель на слово (WORD), определяющее индекс значка, дескриптор которого должен быть получен. Если дескриптор значка получается из исполняемого файла, функция хранит идентификатор значка в слове (WORD), указанном при помощи параметра lpiIcon.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение - дескриптор значка. Если значок извлечен из связанного исполняемого файла, функция хранит полный путь и имя исполняемого файла в строке, указанной при помощи параметра lpIconPath, хранит идентификатор значка в слове (WORD), указанном при помощи параметра lpiIcon.

Если функция завершается ошибкой, возвращаемое значение - NULL.

Замечания

Функция ExtractAssociatedIcon сначала ищет индексированный значок в файле, определенном параметром lpIconPath. Если функция не может получить дескриптор значка от этого файла, и файл имеет связанный исполняемый файл, она ищет дескриптор для значка в этом исполняемом файле. Связи с исполняемыми файлами основаны на расширениях имени файла, сохраняются в части реестра пользователя и могут быть определены, используя команду апплета File Manager's Associate.

Смотри также

Обзор Значки, Функции, используемые значками, ExtractIcon

Размещение и совместимость ExtractAssociatedIcon
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.5 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows 2003 Server Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.5 и выше
в
е
р
Используемая библиотека Shell32.lib
Используемая DLL shell32.dll
Заголовочный файл
- объявлено в Shellapi.h
- включено в -
Unicode Реализуется как версии ANSI и Unicode
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz