LocalDiscard-Makro (minwinbase.h)

Verwirft das angegebene lokale Speicherobjekt. Die Sperranzahl des Speicherobjekts muss 0 sein.

Hinweis Die lokalen Funktionen weisen einen größeren 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

void LocalDiscard(
  [in]  h
);

Parameter

[in] h

Ein Handle für das lokale Speicherobjekt. Dieses Handle wird entweder von der Funktion LocalAlloc oder LocalReAlloc zurückgegeben.

Rückgabewert

Keine

Bemerkungen

Obwohl LocalDiscard den Speicherblock des Objekts verwirft, bleibt das Handle für das Objekt gültig. Ein Prozess kann das Handle anschließend an die LocalReAlloc-Funktion übergeben, um ein weiteres lokales Speicherobjekt zuzuweisen, das durch dasselbe Handle identifiziert wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile minwinbase.h (einschließlich Windows.h)

Weitere Informationen

Globale und lokale Funktionen

LocalAlloc

LocalReAlloc

Speicherverwaltungsfunktionen