Compartir a través de


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 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

Consulte también

Conceptual

FindResource

FindResourceEx

LoadLibrary

Loadmodule

LockResource

Otros recursos

Referencia

Recursos