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 de 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.
Valor de retorno
Se a chamada para RtlDestroyHeap for bem-sucedida, o valor retornado será um ponteiro de NULL.
Se a chamada para RtlDestroyHeap falhar, o valor retornado será um identificador para o heap.
Observações
Os processos podem chamar rtlDestroyHeap sem primeiro chamar rtlFreeHeap para liberar memória que foi alocada do heap.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |