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

Weitere Informationen

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap