Метод ICorDebugProcess5::EnumerateHeapRegionsICorDebugProcess5::EnumerateHeapRegions Method

Возвращает перечислитель для диапазонов памяти управляемой кучи.Gets an enumerator for the memory ranges of the managed heap.

СинтаксисSyntax

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

ПараметрыParameters

ppRegions
заполняет Указатель на адрес объекта интерфейса икордебугхеапсегментенум , который является перечислителем для диапазонов памяти, в которых объекты находятся в управляемой куче.[out] A pointer to the address of an ICorDebugHeapSegmentEnum interface object that is an enumerator for the ranges of memory in which objects reside in the managed heap.

RemarksRemarks

Перед вызовом ICorDebugProcess5::EnumerateHeapRegions метода необходимо вызвать метод метод ICorDebugProcess5:: GetGCHeapInformation и проверить значение areGCStructuresValid поля возвращенного COR_HEAPINFO объекта, чтобы гарантировать, что куча сборки мусора в ее текущем состоянии является перечислимым.Before calling the ICorDebugProcess5::EnumerateHeapRegions method, you should call the ICorDebugProcess5::GetGCHeapInformation method and examine the value of the areGCStructuresValid field of the returned COR_HEAPINFO object to ensure that the garbage collection heap in its current state is enumerable. Кроме ICorDebugProcess5::EnumerateHeapRegions того, метод возвращает, E_FAIL Если вы присоединяетесь слишком рано в течение времени существования процесса до создания областей памяти.In addition, the ICorDebugProcess5::EnumerateHeapRegions method returns E_FAIL if you attach too early in the lifetime of the process, before memory regions are created.

Этот метод гарантирует перечисление всех областей памяти, которые могут содержать управляемые объекты, но не гарантирует, что управляемые объекты фактически находятся в этих регионах.This method is guaranteed to enumerate all memory regions that may contain managed objects, but it does not guarantee that managed objects actually reside in those regions. Объект коллекции икордебугхеапсегментенум может включать в себя пустые или зарезервированные регионы памяти.The ICorDebugHeapSegmentEnum collection object may include empty or reserved memory regions.

Объект интерфейса икордебугхеапсегментенум является стандартным перечислителем, производным от интерфейса ICorDebugEnum, который позволяет перечислить COR_SEGMENTные объекты.The ICorDebugHeapSegmentEnum interface object is a standard enumerator derived from the ICorDebugEnum interface that allows you to enumerate COR_SEGMENT objects. Каждый объект COR_SEGMENT предоставляет сведения о диапазоне памяти определенного сегмента вместе с поколением объектов в этом сегменте.Each COR_SEGMENT object provides information about the memory range of a particular segment, along with the generation of the objects in that segment.

ТребованияRequirements

Платформы: см. раздел Требования к системе.Platforms: See System Requirements.

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

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

Платформа .NET Framework версии:Доступно с версии 4.5Available since 4.5.NET Framework Versions: Доступно с версии 4.5Available since 4.5

См. такжеSee also