Fonction RtlFreeHeap

Libère un bloc de mémoire qui a été alloué à partir d’un tas par RtlAllocateHeap.

Syntaxe

BOOLEAN RtlFreeHeap(
  _In_     PVOID HeapHandle,
  _In_opt_ ULONG Flags,
  _In_     PVOID HeapBase
);

Paramètres

HeapHandle [in]

Handle pour le tas dont le bloc de mémoire doit être libéré. Ce paramètre est un handle retourné par RtlCreateHeap.

Indicateurs [in, facultatif]

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 lors de la création du tas par RtlCreateHeap.

Indicateur	Signification
HEAP_NO_SERIALIZE	L’exclusion mutuelle ne sera pas utilisée lorsque RtlFreeHeap accède au tas.

 

HeapBase [in]

Pointeur vers le bloc de mémoire libre. Ce pointeur est retourné par RtlAllocateHeap.

Valeur retournée

Retourne TRUE si le bloc a été libéré avec succès ; FALSE dans le cas contraire.

Notes

À compter de Windows 8 la valeur de retour est tapée comme LOGICAL, qui a une taille différente de BOOLEAN.

 

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Universal
En-tête	Ntifs.h (inclure Ntifs.h)
Bibliothèque	Ntdll.lib
DLL	Ntdll.dll

Voir aussi

RtlAllocateHeap

RtlCreateHeap

RtlDestroyHeap