Funzione RtlFreeHeap (ntifs.h)
La routine RtlFreeHeap libera un blocco di memoria allocato da un heap 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 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.
| Bandiera | 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 da BOOLEAN.
Fabbisogno
| 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 |