Partager via


GetProcessHeap, fonction (heapapi.h)

Récupère un handle dans le tas par défaut du processus appelant. Ce handle peut ensuite être utilisé dans les appels suivants aux fonctions de tas.

Syntaxe

HANDLE GetProcessHeap();

Valeur de retour

Si la fonction réussit, la valeur de retour est un handle pour le tas du processus appelant.

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

Remarques

La fonction GetProcessHeap obtient un handle pour le tas par défaut pour le processus appelant. Un processus peut utiliser ce handle pour allouer de la mémoire à partir du tas de processus sans avoir à créer d’abord un tas privé à l’aide de la fonction HeapCreate .

Windows Server 2003 et Windows XP : Pour activer le tas à faible fragmentation pour le tas par défaut du processus, appelez la fonction HeapSetInformation avec le handle retourné par GetProcessHeap.

Exemples

Pour obtenir un exemple, consultez Obtention de tas de processus.

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