Função RtlFreeHeap (ntifs.h)
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 |