Функция LockResource блокирует указанный ресурс в памяти.
Синтаксис
LPVOID LockResource( HGLOBAL hResData ); |
Параметры
hResData
[in] Дескриптор ресурса, который будет блокирован. Функция LoadResource возвращает этот дескриптор.
| Обратите внимание! на то, что этот параметр внесен в список как переменная HGLOBAL только для совместимости назад. Не передавайте какое-либо значение как параметр, который другой, а не успешное возвращаемое значение из функции LoadResource. |
Возвращаемое значение
Если загруженный ресурс блокируется, возвращаемое значение - указатель на первый байт ресурса; или же, это - ПУСТО (NULL).
Замечания
Указатель, возвращенный функцией LockResource допустим до тех пор, пока модуль, содержащий ресурс, не выгрузится. Нет необходимости разблокировывать ресурсы, потому что система автоматически удаляет их, когда процесс, который создавал ресурсы, завершает работу.
Не пытайтесь блокировать ресурс, используя дескриптор, возвращенный функцией FindResource или FindResourceEx. Такой дескриптор указывает на произвольные данные.
Пример
Пример, см. в статье Корректировка ресурсов.
Смотри такжеОбзор Ресурсы, Функции, используемые ресурсами, FindResource, FindResourceEx, LoadResource
| Размещение и совместимость LockResource | |
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Kernel32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winbase.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |