Função RtlFreeHeap

Libera um bloco de memória que foi alocado de um heap por RtlAllocateHeap.

Sintaxe

BOOLEAN RtlFreeHeap(
  _In_     PVOID HeapHandle,
  _In_opt_ ULONG Flags,
  _In_     PVOID HeapBase
);

Parâmetros

HeapHandle [in]

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

Sinalizadores [in, opcional]

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.

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

 

HeapBase [in]

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

Valor retornado

Retornará TRUE se o bloco tiver sido liberado com êxito; FALSE caso contrário.

Observação

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

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de destino
Universal
Cabeçalho
Ntifs.h (inclua Ntifs.h)
Biblioteca
Ntdll.lib
DLL
Ntdll.dll

Confira também

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap