Fonction RtlFreeHeap (ntifs.h)

  • Article

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

Voir aussi

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap