Heap32ListFirst, fonction (tlhelp32.h)

Article
03/02/2024

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