ICorDebugProcess5::EnumerateHeapRegions 메서드

관리되는 힙의 메모리 범위에 대한 열거자를 가져옵니다.

Syntax

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

매개 변수

ppRegions [out] 개체가 관리되는 힙에 있는 메모리 범위에 대한 열거자인 ICorDebugHeapSegmentEnum 인터페이스 개체의 주소에 대한 포인터입니다.

비고

메서드를 ICorDebugProcess5::EnumerateHeapRegions 호출하기 전에 ICorDebugProcess5::GetGCHeapInformation 메서드를 호출하고 반환된 areGCStructuresValid 개체의 필드 값을 검사하여 현재 상태의 가비지 수집 힙을 열거할 수 있는지 확인해야 합니다. 또한 ICorDebugProcess5::EnumerateHeapRegions 메모리 영역을 만들기 전에 프로세스 수명 중 너무 일찍 연결하면 메서드가 반환 E_FAIL 됩니다.

이 메서드는 관리되는 개체를 포함할 수 있는 모든 메모리 영역을 열거하도록 보장되지만 관리되는 개체가 실제로 해당 지역에 상주한다고 보장하지는 않습니다. ICorDebugHeapSegmentEnum 컬렉션 개체에는 빈 메모리 영역 또는 예약된 메모리 영역이 포함될 수 있습니다.

ICorDebugHeapSegmentEnum 인터페이스 개체는 COR_SEGMENT 개체를 열거할 수 있는 ICorDebugEnum 인터페이스에서 파생된 표준 열거자입니다. 각 COR_SEGMENT 개체는 특정 세그먼트의 메모리 범위와 해당 세그먼트의 개체 생성에 대한 정보를 제공합니다.

요구 사항

플랫폼:.NET 지원 운영 체제를 참조하세요.

머리글: CorDebug.idl, CorDebug.h

도서관: CorGuids.lib

.NET 버전: .NET Framework 4.5 이후 사용 가능

참고하십시오

• ICorDebugProcess5 인터페이스