GlobalDiscard-Makro (winbase.h)
Verwirft den angegebenen globalen Speicherblock. Die Sperranzahl des Speicherobjekts muss null sein.
Hinweis Die globalen 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 globale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.
Syntax
void GlobalDiscard(
[in] h
);
Parameter
[in] h
Ein Handle für das globale Speicherobjekt. Dieses Handle wird entweder von der Funktion GlobalAlloc oder GlobalReAlloc zurückgegeben.
Rückgabewert
Keine
Bemerkungen
Obwohl GlobalDiscard den Speicherblock des Objekts verwirft, bleibt das Handle für das Objekt gültig. Der Prozess kann das Handle anschließend an die GlobalReAlloc-Funktion übergeben, um einen anderen globalen Speicherblock zuzuweisen, der durch dasselbe Handle identifiziert wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |