Função RtlDestroyHeap (ntifs.h)
A rotina RtlDestroyHeap destrói o objeto heap especificado. RtlDestroyHeap descompromissa e libera todas as páginas de um objeto heap privado e invalida o identificador para o heap.
Sintaxe
NTSYSAPI PVOID RtlDestroyHeap(
[in] PVOID HeapHandle
);
Parâmetros
[in] HeapHandle
Manipule para que o heap seja destruído. Esse parâmetro é um identificador de heap retornado por RtlCreateHeap.
Retornar valor
Se a chamada para RtlDestroyHeap for bem-sucedida, o valor retornado será um ponteiro NULL .
Se a chamada para RtlDestroyHeap falhar, o valor retornado será um identificador para o heap.
Comentários
Os processos podem chamar RtlDestroyHeap sem primeiro chamar RtlFreeHeap para liberar a memória alocada do heap.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |