Función LoadResource (libloaderapi.h)

Recupera un identificador que se puede usar para obtener un puntero al primer byte del recurso especificado en memoria.

Sintaxis

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

Parámetros

[in, optional] hModule

Tipo: HMODULE

Identificador del módulo cuyo archivo ejecutable contiene el recurso. Si hModule es NULL, el sistema carga el recurso del módulo que se usó para crear el proceso actual.

[in] hResInfo

Tipo: HRSRC

Identificador del recurso que se va a cargar. La función FindResource o FindResourceEx devuelve este identificador.

Valor devuelto

Tipo: HGLOBAL

Si la función se ejecuta correctamente, el valor devuelto es un identificador de los datos asociados al recurso.

Si se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

El tipo de valor devuelto loadResource es HGLOBAL por compatibilidad con versiones anteriores, no porque la función devuelve un identificador a un bloque de memoria global. No pase este identificador a la función GlobalLock o GlobalFree . Para obtener un puntero al primer byte de los datos del recurso, llame a la función LockResource ; para obtener el tamaño del recurso, llame a SizeofResource.

GlobalSize devuelve 0 para un recurso HGLOBAL. Como resultado, las API que dependen de GlobalSize para determinar el tamaño del HGLOBAL no funcionarán correctamente. Por ejemplo, use SHCreateMemStream en lugar de CreateStreamOnHGlobal.

Para usar un recurso inmediatamente, una aplicación debe usar las siguientes funciones específicas del recurso para buscar y cargar el recurso en una llamada.

Por ejemplo, una aplicación puede usar la función LoadIcon para cargar un icono para mostrarlo en la pantalla, seguido de DestroyIcon cuando haya terminado.

Ejemplos

Para obtener un ejemplo, consulte Actualización de recursos.

Requisitos

Consulte también

FindResource

FindResourceEx

loadLibrary

LoadModule

LockResource