Freigeben über


HeapDestroy-Funktion (heapapi.h)

Zerstört das angegebene Heapobjekt.

HeapDestroy de-committ und gibt alle Seiten eines privaten Heapobjekts frei, und das Handle wird für den Heap ungültig.

Syntax

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

Parameter

[in] hHeap

Ein Handle zum zu zerstörenden Heap. Dieses Handle wird von der HeapCreate-Funktion zurückgegeben. Verwenden Sie das Handle nicht für den Prozessheap, der von der GetProcessHeap-Funktion zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Prozesse können HeapDestroy aufrufen, ohne zuerst die HeapFree-Funktion aufzurufen, um den vom Heap zugewiesenen Arbeitsspeicher freizugeben.

Beispiele

Auflisten eines Heaps

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile heapapi.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Heapfunktionen

HeapCreate

Speicherverwaltungsfunktionen

In VBS-Enklaven verfügbare Vertdll-APIs