GlobalDiscard-Makro (winbase.h)

  • Artikel

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)

Weitere Informationen

Globale und lokale Funktionen

Globalalloc

GlobalReAlloc

Speicherverwaltungsfunktionen