다음을 통해 공유

ICorDebugProcess5::EnumerateHeapRegions 메서드

  • 아티클

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

구문

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

매개 변수

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

설명

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

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

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

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: CorDebug.idl, CorDebug.h

라이브러리: CorGuids.lib

.NET Framework 버전: 4.5부터 사용 가능

참고 항목