Функция LoadResource загружает указанный ресурс в глобальную память.
Синтаксис
HGLOBAL LoadResource( HMODULE hModule, HRSRC hResInfo ); |
Параметры
hModule
[in] Дескриптор модуля, исполняемый файл которого содержит ресурс. Если hModule - ПУСТО (NULL), система загружает ресурс из модуля, который использовался, чтобы создать текущий процесс.hResInfo
[in] Дескриптор загружаемого ресурса. Этот дескриптор возвращается функцией FindResource или FindResourceEx.Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - дескриптор данных, связанных с ресурсом.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Тип возвращаемого значения из
функции LoadResource - HGLOBAL для обратной
совместимости, а не потому, что функция
возвращает дескриптор блока данных
глобальной памяти. Не передавайте этот
дескриптор в функцию
Чтобы использовать ресурс немедленно, приложение должно использовать нижеследующие, определяющие ресурсы,функции, чтобы найти и загрузить ресурс при первом вызове.
| Функция | Действие | Чтобы удалить ресурс |
|---|---|---|
| FormatMessage | Загружает и форматирует запись таблицы сообщений | Ничего не надо |
| LoadAccelerators | Загружает таблицу клавиш-ускорителей | DestroyAcceleratorTable |
| LoadBitmap | Загружает растровый ресурс | DeleteObject |
| LoadCursor | Загружает ресурс курсора | DestroyCursor |
| LoadIcon | Загружает ресурс значка | DestroyIcon |
| LoadMenu | Загружает ресурс меню | DestroyMenu |
| LoadString | Загружает строковый ресурс | Ничего не надо |
Например, приложение может использовать функцию LoadIcon, чтобы загрузить значок для вывода на экран дисплея, сопровождаемую DestroyIcon, когда все сделано.
Система автоматически удаляет эти ресурсы, когда процесс, который создавал их, завершает работу, однако, вызов соответствующей функции, сохраняет память и уменьшает размер рабочего набора страниц физической памяти процесса.
Пример
Пример, см. в статье Корректировка ресурсов.
Смотри такжеОбзор Ресурсы, Функции, используемые ресурсами, FindResource, FindResourceEx, LoadLibrary, LoadModule, LockResource
| Размещение и совместимость LoadResource | |
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Kernel32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |