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
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 |