Русский справочник по Win32 API

В случае успеха возвращается дескриптор блока с информацией об указанном ресурсе. Для получения дескриптора ресурса передайте этот дескриптор в функцию LoadResource .

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

Комментарии

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

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

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

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

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

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

См. также

FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource .

FindResourceEx

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

HRSRC FindResourceEx (

HMODULE hModule , // дескриптор модуля ресурса

LPCTSTR lpName , // указатель на имя ресурса

LPCTSTR lpType // указатель на тип ресурса

WORD wLanguage // язык ресурса

);

Параметры

hModule - дескриптор модуля, чей исполняемый файл содержит ресурс. Значение параметра, равное NULL, определяет дескриптор модуля, связанного с загрузочным файлом, который использовала операционная система для создания текущего процесса.

lpName - определяет имя ресурса. Для дополнительной информации смотрите раздел "Комментарии".

lpType - определяет тип ресурса. Для дополнительной информации смотрите раздел "Комментарии". Для стандартных типов ресурсов этот параметр может принимать одно из следующих значений:

Значение	Пояснение
RT_ACCELERATOR	Таблица акселераторов.
RT_ANICURSOR	Анимированный курсор.
RT_ANIICON	Анимированная иконка.
RT_BITMAP	Битовое изображение.
RT_CURSOR	Зависимый от аппаратного обеспечения курсор.
RT_DIALOG	Диалоговое окно.
RT_FONT	Шрифт .
RT_FONTDIR	Таблица шрифтов .
RT_GROUP_CURSOR	Независимый от аппаратного обеспечения курсор.
RT_GROUP_ICON	Независимая от аппаратного обеспечения иконка.
RT_ICON	Зависимая от аппаратного обеспечения иконка.
RT_MENU	Меню .
RT_MESSAGETABLE	Элемент таблицы сообщений.
RT_RCDATA	Определяемые приложением ресурсы.
RT_STRING	Элемент таблицы строк.
RT_VERSION	Информация о версии.

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