Функция FindResourceExW (libloaderapi.h)

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

Синтаксис

HRSRC FindResourceExW(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpType,
  [in]           LPCWSTR lpName,
  [in]           WORD    wLanguage
);

Параметры

[in, optional] hModule

Тип: HMODULE

Дескриптор модуля, переносимый исполняемый файл или сопровождающий файл MUI содержит ресурс. Если этот параметр имеет значение NULL, функция выполняет поиск модуля, используемого для создания текущего процесса.

[in] lpType

Тип: LPCTSTR

Тип ресурса. Кроме того, вместо указателя этот параметр может быть MAKEINTRESOURCE(ID), где идентификатор является целым идентификатором заданного типа ресурса. Стандартные типы ресурсов см. в разделе "Типы ресурсов". Дополнительные сведения см. в разделе "Примечания" ниже.

[in] lpName

Тип: LPCTSTR

Имя ресурса. Кроме того, вместо указателя этот параметр может быть MAKEINTRESOURCE(ID), где идентификатор является целым идентификатором ресурса. Дополнительные сведения см. в разделе "Примечания" ниже.

[in] wLanguage

Тип: WORD

Язык ресурса. Если этот параметр имеет значение MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), используется текущий язык, связанный с вызывающим потоком.

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

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

Тип: HRSRC

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

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

Замечания

Если IS_INTRESOURCE имеет значение TRUE для x = lpType или lpName, x задает целочисленный идентификатор типа или имени данного ресурса. В противном случае эти параметры являются длинными указателями на строки, завершаемые значением NULL. Если первый символ строки является знаком фунта (#), остальные символы представляют десятичное число, указывающее целочисленный идентификатор имени или типа ресурса. Например, строка "#258" представляет целочисленный идентификатор 258.

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

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

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

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

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

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
Header	libloaderapi.h (включая Windows.h)
Library	kernel32. Lib
DLL	Kernel32.dll

См. также

FindResource
FormatMessage
IS_INTRESOURCE
LoadAccelerator
LoadBitmap
LoadCursor
LoadIcon
LoadMenu
LoadResource
LoadString
MAKELANGID

другие ресурсы

Справочные материалы
Ресурсы