ICorDebugProcess5 ::EnumerateHeap, méthode

Obtient un énumérateur pour les objets sur le tas managé.

Syntaxe

HRESULT EnumerateHeap(
    [out] ICorDebugHeapEnum **ppObjects
);

Paramètres

ppObject [out] Pointeur vers l’adresse d’un objet d’interface ICorDebugHeapEnum qui est un énumérateur pour les objets qui résident sur le tas managé.

Remarques

Avant d’appeler la ICorDebugProcess5::EnumerateHeap méthode, vous devez appeler la méthode ICorDebugProcess5 ::GetGCHeapInformation et examiner la valeur du champ de areGCStructuresValid l’objet COR_HEAPINFO retourné pour vous assurer que le tas de garbage collection dans son état actuel est énumérable. En outre, les ICorDebugProcess5::EnumerateHeap retours E_FAIL si vous attachez trop tôt dans la durée de vie du processus, avant que la mémoire du tas managé soit allouée.

L’objet d’interface ICorDebugHeapEnum est un énumérateur standard dérivé de l’interface ICorDebugEnum qui vous permet d’énumérer des objets COR_HEAPOBJECT . Cette méthode remplit l’objet de collection ICorDebugHeapEnum avec COR_HEAPOBJECT instances qui fournissent des informations sur tous les objets. La collection peut également inclure des instances COR_HEAPOBJECT qui fournissent des informations sur les objets qui ne sont pas rootés par un objet, mais qui n’ont pas encore été collectées par le garbage collector.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 4.5

Voir aussi

• ICorDebugProcess5, interface