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