RtlFreeHeap fonction)

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

Syntaxe

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

Paramètres

HeapHandle [ dans]

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

Indicateurs [ dans, facultatif]

Jeu 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 segment de mémoire a été créé par RtlCreateHeap.

Indicateur Signification
segment de mémoire _ non _ sérialisé
L’exclusion mutuelle n’est pas utilisée quand RtlFreeHeap accède au segment de mémoire.

HeapBase [ dans]

Pointeur vers le bloc de mémoire à libérer. Ce pointeur est retourné par RtlAllocateHeap.

Valeur retournée

Retourne la valeur true si le bloc a été correctement libéré ; False dans le cas contraire.

Notes

à partir de Windows 8 la valeur de retour est de type logique, dont la taille est différente de la valeur booléenne.

Configuration requise

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