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

  • Статья

Извлекает указатель на указанный ресурс в памяти.

Синтаксис

LPVOID LockResource(
  [in] HGLOBAL hResData
);

Параметры

[in] hResData

Тип: HGLOBAL

Дескриптор ресурса, к который требуется получить доступ. Функция LoadResource возвращает этот дескриптор. Обратите внимание, что этот параметр указан как переменная HGLOBAL только для обеспечения обратной совместимости. Не передайте значение в качестве параметра, отличного от успешного возвращаемого значения из функции LoadResource .

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

Тип: LPVOID

Если загруженный ресурс доступен, возвращаемое значение является указателем на первый байт ресурса; В противном случае значение равно NULL.

Комментарии

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

Не пытайтесь заблокировать ресурс с помощью дескриптора, возвращаемого функцией FindResourceA или Функцией FindResourceExA . Такой дескриптор указывает на случайные данные.

Примечание

LockResource фактически не блокирует память; он просто используется для получения указателя на память, содержащую данные ресурса. Имя функции происходит из версий, предшествующих Windows XP, когда она использовалась для блокировки глобального блока памяти, выделенного LoadResource.

Примеры

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header libloaderapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Основные понятия

Ссылка