Partager via


Fonction RtlDestroyHeap (ntifs.h)

La routine RtlDestroyHeap détruit l’objet tas spécifié. RtlDestroyHeap decommits et libère toutes les pages d’un objet de tas privé, et invalide le handle dans le tas.

Syntaxe

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

Paramètres

[in] HeapHandle

Handle pour que le tas soit détruit. Ce paramètre est un handle de tas retourné par RtlCreateHeap.

Valeur de retour

Si l’appel à RtlDestroyHeap réussit, la valeur de retour est un pointeur NULL.

Si l’appel à RtlDestroyHeap échoue, la valeur de retour est un handle pour le tas.

Remarques

Les processus peuvent appeler RtlDestroyHeap sans appeler d’abord RtlFreeHeap pour libérer de la mémoire allouée à partir du tas.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP
plateforme cible Universel
d’en-tête ntifs.h (include Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap