Funzione RtlFreeHeap (ntifs.h)
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 |