FindResourceEx

Функция FindResourceEx определяет местонахождение ресурса с указанным типом, имя и язык в указанном модуле.

() HRSRC FindResourceEx HMODULE  hModule, / / обработать модульLPCTSTRlpType, / / тип указателя ресурсаLPCTSTRlpName, / / указатель на название ресурсаСловоwLanguage / / язык ресурса ) 

Параметры

hModule
Дескриптор модуля, чьи исполняемый файл содержит ресурс. Если этот параметр имеет значение NULL, функция выполняет поиск модуля, используемый для создания текущего процесса.
lpType
Указатель на ограниченную значением null строку, указав имя типа ресурса. Для получения дополнительной информации см. раздел «Примечания». Для стандартных ресурсов типов этот параметр может принимать одно из следующих значений:
Значение Значение
RT_ACCELERATOR Таблица сочетаний клавиш
RT_ANICURSOR Анимированный курсор
RT_ANIICON Анимированный значок
RT_BITMAP Ресурса точечного рисунка
RT_CURSOR Ресурс аппаратно зависимую курсора
RT_DIALOG Диалоговое окно ""
RT_FONT Ресурс шрифта
RT_FONTDIR Каталог ресурса шрифтов
RT_GROUP_CURSOR Курсор аппаратно независимый ресурс
RT_GROUP_ICON Ресурс значка аппаратно независимый
RT_HTML HTML-документ
RT_ICON Ресурс значка аппаратно зависимую
RT_MENU Ресурс меню
RT_MESSAGETABLE Запись сообщений таблицы
RT_RCDATA Определяемый приложением ресурс (исходных данных)
RT_STRING Запись строк таблицы
RT_VERSION Ресурс версии

lpName
Указатель на ограниченную значением null строку, указав имя ресурса. Для получения дополнительных сведений см. раздел «Примечания».
wLanguage
Указывает язык ресурса. Если этот параметр равен MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), используется текущий язык, связанный с вызывающим потоком.

Чтобы задать язык, отличный от текущего языка, используйте макрос MAKELANGID для создания этот параметр. Для получения дополнительной информации, смотрите MAKELANGID.

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

Если функция выполнена успешно, возвращаемое значение является дескриптором для блока сведений о указанного ресурса. Чтобы получить дескриптор для ресурса, этот дескриптор LoadResource функцию передайте.

Если вызов функции был неуспешен, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Если Верховный слово параметра lpType или lpName равно нулю, низкой слово указывает целочисленный идентификатор типа или имя данного ресурса. В противном случае эти параметры являются указатели на строки с завершающим нулем. Если первый символ строки знак фунта (#), оставшиеся знаки представляют собой десятичное число, которое указывает целочисленный идентификатор имени или типа ресурса. Например строка «# 258» обозначает целочисленный идентификатор 258.

Приложения следует уменьшить количество памяти, необходимой для ресурсов, ссылаясь на них целочисленный идентификатор, а не по имени.

Когда вы закончены, с помощью таблицы сочетаний клавиш, растровые, курсора, значка или меню, можно отпустить его ассоциированных память путем вызова одной из функций в таблице.

Ресурс Функция выпуска
Таблица сочетаний клавиш DestroyAcceleratorTable
Точечный рисунок DeleteObject
Курсор DestroyCursor
Значок DestroyIcon
Меню DestroyMenu

Система автоматически удаляет эти ресурсы после завершения процесса, который создал их, однако, соответствующие функции экономит память и уменьшает размер рабочего множества процесса.

Приложение может использовать FindResourceEx для поиска любого типа ресурса, но эта функция должна использоваться только если приложение должно получить доступ к данным двоичного ресурса при последующих вызовах функции LoadLibrary и LockResource.

Использовать ресурс немедленно, приложение должно использовать следующие функции отдельных ресурсов для поиска и загрузки ресурсов в одном вызове:

Функция Действия
FormatMessage Загружает и форматирует запись в таблице сообщений.
LoadAccelerators Загружает таблицу сочетаний клавиш.
LoadBitmap Загружает ресурс растрового изображения.
LoadCursor Загружает ресурс курсора.
LoadIcon Загружает ресурс значка.
LoadMenu Загружает ресурс меню.
LoadString Загружает запись в таблице строк.

Например приложение может использовать функцию LoadIcon для загрузки значок для отображения на экране. Однако приложение должно использовать FindResourceEx и LoadResource , если оно загружается значок копировать свои данные в другое приложение.

Строковые ресурсы хранятся в секции до 16 строк одной секции. Строки в каждом разделе хранятся как последовательность (не нулем) строки Юникода. Функция LoadString будет извлекать строковый ресурс из соответствующего раздела.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winbase.h.
Импорта библиотеки:Используйте kernel32.lib.
Юникод:В Unicode и ANSI версий Windows и Windows NT.

Родственные слова

Обзор ресурсов, функций ресурсов, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index