Função RtlFreeHeap (ntifs.h)

Artigo
02/07/2025

A rotina RtlFreeHeap libera um bloco de memória que foi alocado de um heap RtlAllocateHeap.

Sintaxe

NTSYSAPI LOGICAL RtlFreeHeap(
  [in]           PVOID                 HeapHandle,
  [in, optional] ULONG                 Flags,
                 _Frees_ptr_opt_ PVOID BaseAddress
);

Parâmetros

[in] HeapHandle

Um identificador para o heap cujo bloco de memória deve ser liberado. Esse parâmetro é um identificador retornado por RtlCreateHeap.

[in, optional] Flags

Um conjunto de sinalizadores que controla aspectos da liberação de um bloco de memória. Especificar o valor a seguir substitui o valor correspondente especificado no parâmetro Flags quando o heap foi criado por RtlCreateHeap.

Bandeira	Significado
HEAP_NO_SERIALIZE	A exclusão mútua não será usada quando rtlFreeHeap estiver acessando o heap.

BaseAddress

Um ponteiro para o bloco de memória a ser liberado. Esse ponteiro é retornado por RtlAllocateHeap.

Valor de retorno

RtlFreeHeap retornará verdadeiro se o bloco tiver sido liberado com êxito; falso caso contrário.

Observação Começando com o Windows 8, o valor retornado é digitado como LOGICAL, que tem um tamanho diferente de BOOLEAN.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows XP.
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Consulte também

rtlAllocateHeap

rtlCreateHeap

rtlDestroyHeap

Compartilhar via