Funzione LoadResource (libloaderapi.h)

Recupera un handle che può essere utilizzato per ottenere un puntatore al primo byte della risorsa specificata in memoria.

Sintassi

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

Parametri

[in, optional] hModule

Tipo: HMODULE

Handle del modulo il cui file eseguibile contiene la risorsa. Se hModule è NULL, il sistema carica la risorsa dal modulo usato per creare il processo corrente.

[in] hResInfo

Tipo: HRRC

Handle per la risorsa da caricare. Questo handle viene restituito dalla funzione FindResource o FindResourceEx .

Valore restituito

Tipo: HGLOBAL

Se la funzione ha esito positivo, il valore restituito è un handle per i dati associati alla risorsa.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

Il tipo restituito di LoadResource è HGLOBAL per compatibilità con le versioni precedenti, non perché la funzione restituisce un handle a un blocco di memoria globale. Non passare questo handle alla funzione GlobalLock o GlobalFree . Per ottenere un puntatore al primo byte dei dati della risorsa, chiamare la funzione LockResource ; per ottenere le dimensioni della risorsa, chiamare SizeofResource.

GlobalSize restituisce 0 per una risorsa HGLOBAL. Di conseguenza, tutte le API che dipendono da GlobalSize per determinare le dimensioni di HGLOBAL non funzioneranno correttamente. Ad esempio, usare SHCreateMemStream anziché CreateStreamOnHGlobal.

Per usare immediatamente una risorsa, un'applicazione deve usare le funzioni specifiche delle risorse seguenti per trovare e caricare la risorsa in una sola chiamata.

Funzione	Azione	Per rimuovere la risorsa
FormatMessage	Carica e formatta una voce di tabella messaggi	Nessuna azione necessaria
LoadAccelerators	Carica una tabella dell'acceleratore	DestroyAcceleratorTable
LoadBitmap	Carica una risorsa bitmap	DeleteObject
LoadCursor	Carica una risorsa cursore	DestroyCursor
LoadIcon	Carica una risorsa icona	DestroyIcon
LoadMenu	Carica una risorsa di menu	DestroyMenu
LoadString	Carica una risorsa stringa	Nessuna azione necessaria

Ad esempio, un'applicazione può usare la funzione LoadIcon per caricare un'icona per la visualizzazione sullo schermo, seguita da DestroyIcon al termine.

Esempi

Per un esempio, vedere Aggiornamento delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Finestre
Intestazione	libloaderapi.h (include Windows.h)
Biblioteca	kernel32.lib
DLL	Kernel32.dll

Vedere anche

FindResource

FindResourceEx

loadLibrary

LoadModule

LockResource