Função RtlFreeHeap (ntifs.h)

  • Artigo

A rotina RtlFreeHeap libera um bloco de memória que foi alocado de um heap por 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.

Sinalizador 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.

Retornar valor

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

Nota 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 Disponível a partir do Windows XP.
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Confira também

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap