Функция ExtractAssociatedIcon

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

Синтаксис

Параметры

hInst

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

lpIconPath

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

lpiIcon

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

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

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

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

Замечания

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

Смотри также

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