RtlDestroyHeap-Funktion (ntifs.h)
Die RtlDestroyHeap-Routine zerstört das angegebene Heapobjekt. RtlDestroyHeap hebt alle Seiten eines privaten Heapobjekts auf und gibt sie frei, und das Handle wird für den Heap ungültig.
Syntax
NTSYSAPI PVOID RtlDestroyHeap(
[in] PVOID HeapHandle
);
Parameter
[in] HeapHandle
Handle für den zu zerstörenden Heap. Dieser Parameter ist ein Heaphandle, das von RtlCreateHeap zurückgegeben wird.
Rückgabewert
Wenn der Aufruf von RtlDestroyHeap erfolgreich ist, ist der Rückgabewert ein NULL-Zeiger .
Wenn der Aufruf von RtlDestroyHeap fehlschlägt, ist der Rückgabewert ein Handle für den Heap.
Hinweise
Prozesse können RtlDestroyHeap aufrufen, ohne zuvor RtlFreeHeap aufzurufen, um Arbeitsspeicher freizugeben, der über den Heap zugewiesen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |