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) |