Funzione RtlFreeHeap (ntifs.h)

  • Articolo

La routine RtlFreeHeap libera un blocco di memoria allocato da un heap da RtlAllocateHeap.

Sintassi

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

Parametri

[in] HeapHandle

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

[in, optional] Flags

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

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

BaseAddress

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

Valore restituito

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

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

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows XP.
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Vedi anche

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap