Heap32First, fonction (tlhelp32.h)

Article
08/26/2023

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