Fonction HeapDestroy (heapapi.h)

Détruit l’objet tas spécifié.

HeapDestroy dés-commite et libère toutes les pages d’un objet de tas privé, et il invalide le handle du tas.

Syntaxe

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

Paramètres

[in] hHeap

Une poignée au tas à détruire. Ce handle est retourné par la fonction HeapCreate . N’utilisez pas le handle dans le tas de processus retourné par la fonction GetProcessHeap .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les processus peuvent appeler HeapDestroy sans appeler d’abord la fonction HeapFree pour libérer la mémoire allouée à partir du tas.

Exemples

Énumération d’un tas

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	heapapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de tas

TasCréer

Fonctions de gestion de la mémoire

API Vertdll disponibles dans les enclaves VBS