Funzione RtlDestroyHeap (ntifs.h)

  • Articolo

La routine RtlDestroyHeap elimina l'oggetto heap specificato. RtlDestroyHeap decommits e rilascia tutte le pagine di un oggetto heap privato e invalida l'handle nell'heap.

Sintassi

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

Parametri

[in] HeapHandle

Handle per l'heap da distruggere. Questo parametro è un handle heap restituito da RtlCreateHeap.

Valore restituito

Se la chiamata a RtlDestroyHeap riesce, il valore restituito è un puntatore NULL .

Se la chiamata a RtlDestroyHeap ha esito negativo, il valore restituito è un handle per l'heap.

Commenti

I processi possono chiamare RtlDestroyHeap senza prima chiamare RtlFreeHeap per liberare memoria allocata dall'heap.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Vedi anche

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap