Función LockResource (libloaderapi.h)
Recupera un puntero al recurso especificado en la memoria.
Sintaxis
LPVOID LockResource(
[in] HGLOBAL hResData
);
Parámetros
[in] hResData
Tipo: HGLOBAL
Identificador del recurso al que se va a tener acceso. La función LoadResource devuelve este identificador. Tenga en cuenta que este parámetro se muestra como una variable HGLOBAL solo por compatibilidad con versiones anteriores. No pase ningún valor como parámetro que no sea un valor devuelto correcto de la función LoadResource .
Valor devuelto
Tipo: LPVOID
Si el recurso cargado está disponible, el valor devuelto es un puntero al primer byte del recurso; de lo contrario, es NULL.
Comentarios
El puntero devuelto por LockResource es válido hasta que se descarga el módulo que contiene el recurso. No es necesario desbloquear recursos porque el sistema los elimina automáticamente cuando finaliza el proceso que los creó.
No intente bloquear un recurso mediante el identificador devuelto por la función FindResourceA o la función FindResourceExA . Este identificador apunta a datos aleatorios.
Nota:
LockResource no bloquea realmente la memoria; solo se usa para obtener un puntero a la memoria que contiene los datos del recurso. El nombre de la función procede de versiones anteriores a Windows XP, cuando se usó para bloquear un bloque de memoria global asignado por LoadResource.
Ejemplos
Para obtener un ejemplo, consulte Actualización de recursos.
Requisitos
Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | libloaderapi.h (incluye Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |