Freigeben über


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

Siehe auch

RtlAllocateHeap-

RtlCreateHeap-

RtlFreeHeap-