Funzione LocalFree (winbase.h)

Articolo
08/27/2023

Libera l'oggetto memoria locale specificato e invalida il relativo handle.

Nota Le funzioni locali hanno un sovraccarico maggiore e offrono meno funzionalità rispetto ad altre funzioni di gestione della memoria. Le nuove applicazioni devono usare le funzioni heap a meno che la documentazione non indichi che deve essere usata una funzione locale. Per altre informazioni, vedere Funzioni globali e locali.

Sintassi

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

Parametri

[in] hMem

Handle per l'oggetto memoria locale. Questo handle viene restituito dalla funzione LocalAlloc o LocalReAlloc . Non è sicuro liberare memoria allocata con GlobalAlloc.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NULL.

Se la funzione ha esito negativo, il valore restituito è uguale a un handle per l'oggetto memoria locale. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se il processo tenta di esaminare o modificare la memoria dopo che è stata liberata, potrebbe verificarsi un danneggiamento dell'heap o generare un'eccezione di violazione di accesso (EXCEPTION_ACCESS_VIOLATION).

Se il parametro hMem è NULL, LocalFree ignora il parametro e restituisce NULL.

La funzione LocalFree libera un oggetto memoria bloccato. Un oggetto memoria bloccata ha un numero di blocchi maggiore di zero. La funzione LocalLock blocca un oggetto memoria locale e incrementa il conteggio dei blocchi di uno. La funzione LocalUnlock lo sblocca e decrementa il conteggio dei blocchi di uno. Per ottenere il numero di blocchi di un oggetto memoria locale, usare la funzione LocalFlags .

Se un'applicazione è in esecuzione in una versione di debug del sistema, LocalFree genererà un messaggio che indica che un oggetto bloccato viene liberato. Se si esegue il debug dell'applicazione, LocalFree immetterà un punto di interruzione appena prima di liberare un oggetto bloccato. In questo modo è possibile verificare il comportamento previsto, quindi continuare l'esecuzione.

Esempio

Per un esempio, vedere LocalAlloc.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll