Función LockResource (libloaderapi.h)

  • Artículo

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

Vea también

Conceptual

Referencia