Fonction RtlFreeHeap (ntifs.h)
La routine RtlFreeHeap libère un bloc de mémoire 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 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 spécifiée dans le paramètre Flags lorsque le tas a été créé par RtlCreateHeap.
| Drapeau | 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 à libérer. Ce pointeur est retourné par RtlAllocateHeap.
Valeur de retour
RtlFreeHeap retourne TRUE si le bloc a été libéré avec succès ; FALSE sinon.
Remarque À partir de Windows 8, la valeur de retour est tapée comme LOGIQUE, qui a une taille différente de BOOLEAN.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows XP. |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |