Функция LoadResource

Функция LoadResource загружает указанный ресурс в глобальную память.

Синтаксис

HGLOBAL LoadResource(
    HMODULE hModule,
    HRSRC hResInfo
);

Параметры

hModule

[in] Дескриптор модуля, исполняемый файл которого содержит ресурс. Если hModule - ПУСТО (NULL), система загружает ресурс из модуля, который использовался, чтобы создать текущий процесс.

hResInfo

[in] Дескриптор загружаемого ресурса. Этот дескриптор возвращается функцией FindResource или FindResourceEx.

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

Если функция завершается успешно, возвращаемое значение - дескриптор данных, связанных с ресурсом.

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Тип возвращаемого значения из функции LoadResource - HGLOBAL для обратной совместимости, а не потому, что функция возвращает дескриптор блока данных глобальной памяти. Не передавайте этот дескриптор в функцию GlobalLock или GlobalFree. Чтобы получить указатель на данные ресурса, вызовите функцию LockResource.

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

 
Функция Действие Чтобы удалить ресурс
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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz