Share via

ICorDebugProcess5::EnumerateHeap, méthode

  • Article

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é.

Notes

Avant d’appeler la méthode ICorDebugProcess5::EnumerateHeap, vous devez appeler la méthode ICorDebugProcess5::GetGCHeapInformation et examiner la valeur du champ areGCStructuresValid de l’objet COR_HEAPINFO retourné pour vous assurer que le tas de garbage collection dans son état actuel est énumérable. En outre, ICorDebugProcess5::EnumerateHeap retourne 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 des instances COR_HEAPOBJECT 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 racinés par un objet, mais qui n’ont pas encore été collectées par le garbage collector.

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