Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verwirft das angegebene lokale Speicherobjekt. Die Sperranzahl des Speicherobjekts muss null sein.
Anmerkung Die lokalen Funktionen haben mehr Aufwand und bieten weniger Features als andere Speicherverwaltungsfunktionen. Neue Anwendungen sollten die Heap-Funktionen verwenden, es sei denn, in der Dokumentation wird angegeben, dass eine lokale Funktion verwendet werden soll. Weitere Informationen finden Sie unter "Globale und lokale Funktionen".
Syntax
HLOCAL LocalDiscard(
[in] HLOCAL h
);
Die Parameter
[in] h
Ein Handle für das lokale Speicherobjekt. Dieses Handle wird entweder von der Funktion "LocalAlloc " oder " LocalReAlloc " zurückgegeben.
Rückgabewert
Typ: HLOCAL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das lokale Speicherobjekt. Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Obwohl LocalDiscard den Speicherblock des Objekts verwirft, bleibt das Handle für das Objekt gültig. Ein Prozess kann anschließend das Handle an die LocalReAlloc-Funktion übergeben, um ein anderes lokales Speicherobjekt zuzuweisen, das durch dasselbe Handle identifiziert wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows XP [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform | Fenster |
| Überschrift | minwinbase.h (include Windows.h) |