Partager via


Heap32ListFirst, fonction (tlhelp32.h)

Récupère des informations sur le premier tas qui a été alloué par un processus spécifié.

Syntaxe

BOOL Heap32ListFirst(
  [in]      HANDLE       hSnapshot,
  [in, out] LPHEAPLIST32 lphl
);

Paramètres

[in] hSnapshot

Un handle au instantané retourné à partir d’un appel précédent à la fonction CreateToolhelp32Snapshot.

[in, out] lphl

Pointeur vers une structure HEAPLIST32 .

Valeur retournée

Retourne TRUE si la première entrée de la liste de tas a été copiée dans la mémoire tampon ou FALSE dans le cas contraire. La valeur d’erreur ERROR_NO_MORE_FILES est retournée par la fonction GetLastError lorsqu’il n’existe aucune liste de tas ou que le instantané ne contient pas d’informations de liste de tas.

Remarques

L’application appelante doit définir le membre dwSize de HEAPLIST32 sur la taille, en octets, de la structure. Heap32ListFirst remplace dwSize par le nombre d’octets écrits dans la structure. Elle ne sera jamais supérieure à la valeur initiale de dwSize, mais elle peut être plus petite. Si la valeur est plus petite, ne vous fiez pas aux valeurs des membres dont les décalages sont supérieurs à cette valeur.

Pour récupérer des informations sur d’autres tas dans la liste des tas, utilisez la fonction Heap32ListNext .

Exemples

Pour obtenir un exemple, consultez Parcourir la liste des tas.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tlhelp32.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CreateToolhelp32Snapshot

HEAPLIST32

Heap Listes et Heap Walking

Heap32ListNext

Fonctions d’aide de l’outil