Funzione LoadResource (libloaderapi.h)

Articolo
08/24/2023

Recupera un handle che può essere usato 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 al 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: HRSRC

Handle alla 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il tipo restituito di LoadResource è HGLOBAL per la 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 chiamata.

Funzione	Azione	Per rimuovere la risorsa
FormatMessage	Carica e formatta una voce di tabella messaggi	Non è richiesta alcuna azione
LoadAccelerators	Carica una tabella 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	Non è richiesta alcuna azione

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

Esempio

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	Windows
Intestazione	libloaderapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll