Funzione RtlFreeHeap

Libera un blocco di memoria allocato da un heap da RtlAllocateHeap.

Sintassi

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

Parametri

HeapHandle [in]

Handle per l'heap il cui blocco di memoria deve essere liberato. Questo parametro è un handle restituito da RtlCreateHeap.

Flag [in, facoltativo]

Set di flag che controlla gli aspetti della liberazione di un blocco di memoria. Se si specifica il valore seguente, viene eseguito l'override del valore corrispondente specificato nel parametro Flags quando l'heap è stato creato da RtlCreateHeap.

Flag Significato
HEAP_NO_SERIALIZE
L'esclusione reciproca non verrà usata quando RtlFreeHeap accede all'heap.

 

HeapBase [in]

Puntatore al blocco di memoria da liberare. Questo puntatore viene restituito da RtlAllocateHeap.

Valore restituito

Restituisce TRUE se il blocco è stato liberato correttamente; FALSE in caso contrario.

Nota

A partire da Windows 8 il valore restituito viene tipizzato come LOGICO, con dimensioni diverse rispetto a BOOLEAN.

 

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Piattaforma di destinazione
Universale
Intestazione
Ntifs.h (include Ntifs.h)
Libreria
Ntdll.lib
DLL
Ntdll.dll

Vedi anche

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap