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.

Requirements

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: CorDebug.idl, CorDebug.h

Biblioteka: CorGuids.lib

Wersje platformy .NET: Dostępne od programu .NET Framework 4.5

Zobacz także

• ICorDebugProcess5, interfejs