Funzione FreeResource (libloaderapi.h)

Articolo
07/21/2023

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