ICorDebugProcess5::EnumerateHeapRegions-metod
Hämtar en uppräkning för minnesintervallen för den hanterade heapen.
Syntax
HRESULT EnumerateHeapRegions(
[out] ICorDebugHeapSegmentEnum **ppRegions
);
Parametrar
ppRegions [ut] En pekare till adressen för ett ICorDebugHeapSegmentEnum-gränssnittsobjekt som är en uppräknare för de minnesintervall där objekt finns i den hanterade heapen.
Kommentarer
Innan du anropar ICorDebugProcess5::EnumerateHeapRegions metoden bör du anropa metoden ICorDebugProcess5::GetGCHeapInformation och undersöka värdet areGCStructuresValid för fältet för det returnerade COR_HEAPINFO-objektet för att säkerställa att skräpinsamlingens heap i dess aktuella tillstånd kan räknas upp. Dessutom ICorDebugProcess5::EnumerateHeapRegions returnerar E_FAIL metoden om du kopplar för tidigt under processens livslängd innan minnesregioner skapas.
Den här metoden är garanterad att räkna upp alla minnesregioner som kan innehålla hanterade objekt, men det garanterar inte att hanterade objekt faktiskt finns i dessa regioner. Samlingsobjektet ICorDebugHeapSegmentEnum kan innehålla tomma eller reserverade minnesregioner.
Gränssnittsobjektet ICorDebugHeapSegmentEnum är en standarduppräknare som härleds från gränssnittet ICorDebugEnum som gör att du kan räkna upp COR_SEGMENT objekt. Varje COR_SEGMENT-objekt innehåller information om minnesintervallet för ett visst segment, tillsammans med genereringen av objekten i det segmentet.
Krav
Plattformar: Se Systemkrav.
Rubrik: CorDebug.idl, CorDebug.h
Bibliotek: CorGuids.lib
.NET Framework-versioner: Finns sedan 4.5
