Partager via


Heap32Next, fonction (tlhelp32.h)

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

Voir aussi

HEAPENTRY32

Tas Listes et Marche en tas

Heap32First

Fonctions d’aide de l’outil