Funzione FreeResource (libloaderapi.h)
Nota
Questa funzione è obsoleta ed è supportata solo per la compatibilità con le versioni precedenti con Windows a 16 bit. Per le applicazioni Windows a 32 bit, non è necessario liberare le risorse caricate usando LoadResource. Per le versioni moderne di Windows questa funzione restituisce sempre FALSE.
Decrementi (riduce di uno) il conteggio dei riferimenti di una risorsa caricata. Quando il numero di riferimenti raggiunge zero, la memoria occupata dalla risorsa viene liberata.
Sintassi
BOOL FreeResource(
[in] HGLOBAL hResData
);
Parametri
[in] hResData
Tipo: HGLOBAL
Handle della risorsa. Si presuppone che hglbResource sia stato creato da LoadResource.
Valore restituito
Tipo: BOOL
Se la funzione ha esito positivo, il valore restituito è zero.
Se la funzione ha esito negativo, il valore restituito è diverso da zero, che indica che la risorsa non è stata liberata.
Commenti
Per le risorse caricate con altre funzioni, FreeResource è stato sostituito dalle funzioni seguenti:
Tipo di risorsa | Sostituzione freeResource |
---|---|
Acceleratore | DestroyAcceleratorTable |
Bitmap | DeleteObject |
Cursore | DestroyCursor |
Icona | DestroyIcon |
Menu | DestroyMenu |
Il conteggio dei riferimenti per una risorsa viene incrementato (aumentato di uno) ogni volta che un'applicazione chiama la funzione LoadResource per la risorsa.
Il sistema elimina automaticamente queste risorse quando il processo che li ha creati termina. Tuttavia, la chiamata alla funzione appropriata salva la memoria. Per altre informazioni, vedere LoadResource.
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 |
Vedere anche
Altre risorse
Riferimento