Partager via

ICorDebugProcess5::EnumerateHeapRegions, méthode

  • Article

Obtient un énumérateur pour les plages mémoire du tas managé.

Syntaxe

HRESULT EnumerateHeapRegions(  
   [out] ICorDebugHeapSegmentEnum **ppRegions  
);

Paramètres

ppRegions
[out] Pointeur vers l’adresse d’un objet d’interface ICorDebugHeapSegmentEnum qui est un énumérateur pour les plages mémoire dans lesquelles les objets résident dans le tas managé.

Notes

Avant d’appeler la méthode ICorDebugProcess5::EnumerateHeapRegions, vous devez appeler la méthode ICorDebugProcess5::GetGCHeapInformation et examiner la valeur du champ areGCStructuresValid de l’objet COR_HEAPINFO renvoyé pour vous assurer que le tas de garbage collection est énumérable dans son état actuel. En outre, la méthode ICorDebugProcess5::EnumerateHeapRegions renvoie E_FAIL en cas d’attachement trop tôt dans la durée de vie du processus, avant la création de régions de mémoire.

Cette méthode garantit l’énumération de toutes les régions de mémoire qui peuvent contenir des objets managés, mais elle ne garantit pas que les objets managés résident réellement dans ces régions. L’objet de collection ICorDebugHeapSegmentEnum peut inclure des régions de mémoire vides ou réservées.

L’objet d’interface ICorDebugHeapSegmentEnum est un énumérateur standard dérivé de l’interface ICorDebugEnum qui vous permet d’énumérer des objets COR_SEGMENT. Chaque objet COR_SEGMENT fournit des informations sur la plage mémoire d’un segment particulier, ainsi que la génération des objets de ce segment.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : disponible depuis la version 4.5

Voir aussi