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 |