Funzione RtlDestroyHeap (ntifs.h)
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 |