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
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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für