ICorDebugProcess5::EnumerateHeapRegions — Metoda
Pobiera moduł wyliczający dla zakresów pamięci zarządzanego sterta.
Składnia
HRESULT EnumerateHeapRegions(
[out] ICorDebugHeapSegmentEnum **ppRegions
);
Parametry
ppRegions [out] Wskaźnik do adresu obiektu interfejsu ICorDebugHeapSegmentEnum , który jest modułem wyliczania zakresów pamięci, w których obiekty znajdują się w zarządzanej stercie.
Uwagi
Przed wywołaniem ICorDebugProcess5::EnumerateHeapRegions metody należy wywołać metodę ICorDebugProcess5::GetGCHeapInformation i zbadać wartość areGCStructuresValid pola zwróconego obiektu COR_HEAPINFO , aby upewnić się, że sterta odzyskiwania pamięci w bieżącym stanie jest wyliczalna. Ponadto ICorDebugProcess5::EnumerateHeapRegions metoda zwraca E_FAIL wartość w przypadku dołączenia zbyt wcześnie w okresie istnienia procesu przed utworzeniem regionów pamięci.
Ta metoda gwarantuje wyliczanie wszystkich regionów pamięci, które mogą zawierać obiekty zarządzane, ale nie gwarantuje, że obiekty zarządzane rzeczywiście znajdują się w tych regionach. Obiekt kolekcji ICorDebugHeapSegmentEnum może zawierać puste lub zarezerwowane regiony pamięci.
Obiekt interfejsu ICorDebugHeapSegmentEnum to standardowy moduł wyliczający pochodzący z interfejsu ICorDebugEnum, który umożliwia wyliczanie obiektów COR_SEGMENT. Każdy obiekt COR_SEGMENT zawiera informacje o zakresie pamięci określonego segmentu wraz z generowaniem obiektów w tym segmencie.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl, CorDebug.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od wersji 4.5
