Heap32Next, fonction (tlhelp32.h)

Article
03/04/2024

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

Syntaxe

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Paramètres

[out] lphe

Pointeur vers une structure HEAPENTRY32 .

Valeur retournée

Retourne TRUE si les informations sur le bloc suivant dans le tas ont été copiées dans la mémoire tampon ou FALSE dans le cas contraire. La fonction GetLastError retourne ERROR_NO_MORE_FILES lorsqu’il n’existe plus d’objets dans le tas et ERROR_INVALID_DATA si le tas semble endommagé ou est modifié pendant la marche de sorte que Heap32Next ne peut pas continuer.

Remarques

Pour récupérer des informations pour le premier bloc d’un tas, utilisez la fonction Heap32First .

La fonction Heap32Next ne conserve pas de référence au processus cible. Si le processus cible meurt, le système peut créer un nouveau processus à l’aide du même identificateur de processus. Par conséquent, l’appelant doit conserver une référence au processus cible tant qu’il utilise 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

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