Partager via


Heap32First, fonction (tlhelp32.h)

Récupère des informations sur le premier bloc d’un tas qui a été alloué par un processus.

Syntaxe

BOOL Heap32First(
  [in, out] LPHEAPENTRY32 lphe,
  [in]      DWORD         th32ProcessID,
  [in]      ULONG_PTR     th32HeapID
);

Paramètres

[in, out] lphe

Pointeur vers une structure HEAPENTRY32 .

[in] th32ProcessID

Identificateur du contexte de processus qui possède le tas.

[in] th32HeapID

Identificateur du tas à énumérer.

Valeur retournée

Retourne TRUE si les informations du premier bloc de tas ont été copiées 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 si le tas n’est pas valide ou vide.

Remarques

L’application appelante doit définir le membre dwSize de HEAPENTRY32 sur la taille, en octets, de la structure. Heap32First 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 accéder aux blocs suivants du même tas, utilisez la fonction Heap32Next .

La marche du tas avec Heap32First et Heap32Next est inefficace, en particulier pour les tas volumineux. Utilisez Plutôt HeapWalk .

Exemples

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

Configuration requise

   
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

HEAPENTRY32

Listes de tas et marche de tas

Heap32Next

Fonctions d’aide de l’outil