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

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

Синтаксис

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

Параметры

[in, optional] hModule

Тип: HMODULE

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

[in] hResInfo

Тип: HRSRC

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

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

Тип: HGLOBAL

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

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

Замечания

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

GlobalSize возвращает значение 0 для ресурса HGLOBAL. В результате все API, зависящие от GlobalSize, чтобы определить размер HGLOBAL, не будут работать правильно. Например, используйте SHCreateMemStream вместо CreateStreamOnHGlobal.

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

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

Примеры

Пример см. в разделе "Обновление ресурсов".

Требования

См. также

FindResource

FindResourceEx

LoadLibrary

LoadModule

LockResource