RtlDestroyHeap-Funktion (ntifs.h)
Die RtlDestroyHeap Routine zerstört das angegebene Heapobjekt. RtlDestroyHeap alle Seiten eines privaten Heapobjekts außer Kraft setzt und den Handle für den Heap ungültig macht.
Syntax
NTSYSAPI PVOID RtlDestroyHeap(
[in] PVOID HeapHandle
);
Parameter
[in] HeapHandle
Handle für den Heap, der zerstört werden soll. Dieser Parameter ist ein Heap-Handle, das von RtlCreateHeapzurü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.
Bemerkungen
Prozesse können RtlDestroyHeap- aufrufen, ohne zuerst RtlFreeHeap- aufzurufen, um Speicher freizugeben, der vom Heap zugewiesen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | < DISPATCH_LEVEL |