Метод ICorDebugProcess5::EnumerateHeapRegions

Возвращает перечислитель для диапазонов памяти управляемой кучи.

Синтаксис

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

Параметры

ppRegions [out] Указатель на адрес объекта интерфейса ICorDebugHeapSegmentEnum , который является перечислителем для диапазонов памяти, в которых объекты находятся в управляемой куче.

Замечания

Перед вызовом ICorDebugProcess5::EnumerateHeapRegions метода необходимо вызвать метод ICorDebugProcess5::GetGCHeapInformation и проверить значение areGCStructuresValid поля возвращаемого объекта COR_HEAPINFO , чтобы убедиться, что куча сборки мусора в текущем состоянии перечислена. Кроме того, метод возвращается E_FAIL при ICorDebugProcess5::EnumerateHeapRegions присоединении слишком рано в течение всего времени существования процесса до создания областей памяти.

Этот метод гарантирует перечисление всех регионов памяти, которые могут содержать управляемые объекты, но не гарантирует, что управляемые объекты фактически находятся в этих регионах. Объект коллекции ICorDebugHeapSegmentEnum может включать пустые или зарезервированные области памяти.

Объект интерфейса ICorDebugHeapSegmentEnum является стандартным перечислителем, производным от интерфейса ICorDebugEnum, который позволяет перечислять объекты COR_SEGMENT . Каждый объект COR_SEGMENT предоставляет сведения о диапазоне памяти определенного сегмента, а также о создании объектов в этом сегменте.

Требования

Платформ: См. сведения о поддерживаемых операционных системах .NET.

Заголовок: CorDebug.idl, CorDebug.h

Библиотека: CorGuids.lib

Версии .NET: Доступно с версии .NET Framework 4.5

См. также

• Интерфейс ICorDebugProcess5