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 |