Partager via


Fonction RtlDestroyHeap (ntifs.h)

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

Syntaxe

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

Paramètres

[in] HeapHandle

Handle pour le tas à détruire. Ce paramètre est un handle de tas retourné par RtlCreateHeap.

Valeur retournée

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 la mémoire allouée à partir du tas.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Voir aussi

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap