Methode ICorDebugProcess5::EnumerateHeap

Hiermee haalt u een enumerator op voor de objecten op de beheerde heap.

Syntaxis

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

Parameters

ppObject
[uit] Een verwijzing naar het adres van een ICorDebugHeapEnum-interfaceobject dat een opsomming is voor de objecten die zich op de beheerde heap bevinden.

Opmerkingen

Voordat u de ICorDebugProcess5::EnumerateHeap methode aanroept, moet u de methode ICorDebugProcess5::GetGCHeapInformation aanroepen en de waarde van het areGCStructuresValid veld van het geretourneerde COR_HEAPINFO-object onderzoeken om er zeker van te zijn dat de heap van de garbagecollection in de huidige staat enumerable is. Bovendien retourneert de ICorDebugProcess5::EnumerateHeap als u te vroeg in de levensduur van het proces koppelt E_FAIL , voordat geheugen voor de beheerde heap wordt toegewezen.

Het interfaceobject ICorDebugHeapEnum is een standaard-enumerator die is afgeleid van de ICorDebugEnum-interface waarmee u COR_HEAPOBJECT-objecten kunt opsommen. Met deze methode wordt het verzamelingsobject ICorDebugHeapEnum gevuld met COR_HEAPOBJECT exemplaren die informatie over alle objecten bieden. De verzameling kan ook COR_HEAPOBJECT exemplaren bevatten die informatie bieden over objecten die niet zijn geroot door een object, maar nog niet zijn verzameld door de garbagecollector.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 4.5

Zie ook

• ICorDebugProcess5 Interface
• Foutopsporingsinterfaces