Methode ICorDebugProcess5::EnumerateHeapRegions

Hiermee haalt u een enumerator op voor de geheugenbereiken van de beheerde heap.

Syntaxis

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

Parameterwaarden

ppRegions [uit] Een aanwijzer naar het adres van een ICorDebugHeapSegmentEnum-interfaceobject dat een enumerator is voor de bereiken van geheugen waarin objecten zich in de beheerde heap bevinden.

Opmerkingen

Voordat u de ICorDebugProcess5::EnumerateHeapRegions methode aanroept, moet u de methode ICorDebugProcess5::GetGCHeapInformation aanroepen en de waarde van het veld van het areGCStructuresValid geretourneerde COR_HEAPINFO-object onderzoeken om ervoor te zorgen dat de garbagecollection heap in de huidige status kan worden opgesomd. Bovendien retourneert de ICorDebugProcess5::EnumerateHeapRegions methode als u te vroeg in de levensduur van het proces koppelt E_FAIL , voordat geheugenregio's worden gemaakt.

Deze methode is gegarandeerd om alle geheugenregio's op te sommen die beheerde objecten kunnen bevatten, maar het garandeert niet dat beheerde objecten zich daadwerkelijk in deze regio's bevinden. Het verzamelingsobject ICorDebugHeapSegmentEnum kan lege of gereserveerde geheugenregio's bevatten.

Het interfaceobject ICorDebugHeapSegmentEnum is een standaard-enumerator die is afgeleid van de ICorDebugEnum-interface waarmee u COR_SEGMENT objecten kunt inventariseren. Elk COR_SEGMENT object bevat informatie over het geheugenbereik van een bepaald segment, samen met de generatie van de objecten in dat segment.

Requirements

Platformen: Zie ondersteunde besturingssystemen van .NET.

Rubriek: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET-versies: Beschikbaar sinds .NET Framework 4.5

Zie ook

• ICorDebugProcess5-interface