Función LoadResource (libloaderapi.h)

Artículo
03/05/2024

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 la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El tipo de valor devuelto de 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.

Función	Acción	Para quitar el recurso
FormatMessage	Carga y da formato a una entrada de tabla de mensajes	No se requiere ninguna acción
LoadAccelerators	Carga una tabla de aceleradores	DestroyAcceleratorTable
LoadBitmap	Carga un recurso de mapa de bits	DeleteObject
LoadCursor	Carga un recurso de cursor	DestroyCursor
LoadIcon	Carga un recurso de icono	Destroyicon
LoadMenu	Carga un recurso de menú	DestroyMenu
LoadString	Carga un recurso de cadena	No se requiere ninguna acción

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

Ejemplos

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

Requisitos

Requisito	Value
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 (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll