Fonction RtlFreeHeap (ntifs.h)
La routine RtlFreeHeap libère un bloc de mémoire qui a été alloué à partir d’un tas par RtlAllocateHeap.
Syntaxe
NTSYSAPI LOGICAL RtlFreeHeap(
[in] PVOID HeapHandle,
[in, optional] ULONG Flags,
_Frees_ptr_opt_ PVOID BaseAddress
);
Paramètres
[in] HeapHandle
Handle pour le tas dont le bloc de mémoire doit être libéré. Ce paramètre est un handle retourné par RtlCreateHeap.
[in, optional] Flags
Ensemble d’indicateurs qui contrôle les aspects de la libération d’un bloc de mémoire. La spécification de la valeur suivante remplace la valeur correspondante qui a été spécifiée dans le paramètre Flags lorsque le tas a été créé par RtlCreateHeap.
| Indicateur | Signification |
|---|---|
| HEAP_NO_SERIALIZE | L’exclusion mutuelle ne sera pas utilisée lorsque RtlFreeHeap accède au tas. |
BaseAddress
Pointeur vers le bloc de mémoire pour libérer. Ce pointeur est retourné par RtlAllocateHeap.
Valeur retournée
RtlFreeHeap retourne TRUE si le bloc a été libéré avec succès ; FALSE dans le cas contraire.
Note À compter de Windows 8 la valeur de retour est tapée comme LOGICAL, qui a une taille différente de booléenne.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows XP. |
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |