LocalFree-Funktion (winbase.h)

Artikel
08/27/2023

Gibt das angegebene lokale Speicherobjekt frei, und sein Handle wird ungültig.

Hinweis Die lokalen Funktionen weisen einen höheren Mehraufwand auf und bieten weniger Features als andere Speicherverwaltungsfunktionen. Neue Anwendungen sollten die Heapfunktionen verwenden, es sei denn, die Dokumentation besagt, dass eine lokale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.

Syntax

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

Parameter

[in] hMem

Ein Handle für das lokale Speicherobjekt. Dieses Handle wird entweder von der Funktion LocalAlloc oder LocalReAlloc zurückgegeben. Es ist nicht sicher, mit GlobalAlloc zugeordneten Arbeitsspeicher freizugeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert NULL.

Wenn die Funktion fehlschlägt, entspricht der Rückgabewert einem Handle für das lokale Speicherobjekt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der Prozess versucht, den Arbeitsspeicher zu untersuchen oder zu ändern, nachdem er freigegeben wurde, kann eine Heapbeschädigung auftreten oder eine Zugriffsverletzungs-Ausnahme (EXCEPTION_ACCESS_VIOLATION) generiert werden.

Wenn der hMem-ParameterNULL ist, ignoriert LocalFree den Parameter und gibt NULL zurück.

Die LocalFree-Funktion gibt ein gesperrtes Speicherobjekt frei. Ein gesperrtes Speicherobjekt weist eine Sperranzahl größer als 0 (null) auf. Die LocalLock-Funktion sperrt ein lokales Speicherobjekt und erhöht die Sperranzahl um eins. Die LocalUnlock-Funktion entsperrt sie und verringert die Sperranzahl um eins. Verwenden Sie die LocalFlags-Funktion , um die Sperranzahl eines lokalen Speicherobjekts abzurufen.

Wenn eine Anwendung unter einer Debugversion des Systems ausgeführt wird, gibt LocalFree eine Meldung aus, die Sie darüber informiert, dass ein gesperrtes Objekt freigegeben wird. Wenn Sie die Anwendung debuggen, gibt LocalFree unmittelbar vor dem Freigeben eines gesperrten Objekts einen Haltepunkt ein. Dadurch können Sie das beabsichtigte Verhalten überprüfen und dann mit der Ausführung fortfahren.

Beispiele

Ein Beispiel finden Sie unter LocalAlloc.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll