ICorDebugProcess5::EnumerateHeap 메서드

  • 아티클

관리되는 힙의 개체에 대한 열거자를 가져옵니다.

구문

HRESULT EnumerateHeap(  
    [out] ICorDebugHeapEnum **ppObjects  
);

매개 변수

ppObject
[out] 관리되는 힙에 있는 개체의 열거자인 ICorDebugHeapEnum 인터페이스 개체의 주소에 대한 포인터입니다.

설명

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

ICorDebugHeapEnum 인터페이스 개체는 COR_HEAPOBJECT 개체를 열거할 수 있는 ICorDebugEnum 인터페이스에서 파생된 표준 열거자입니다. 이 메서드는 모든 개체에 대한 정보를 제공하는 COR_HEAPOBJECT 인스턴스로 ICorDebugHeapEnum 컬렉션 개체를 채웁니다. 수집에는 개체에 대한 정보를 제공하는 COR_HEAPOBJECT 인스턴스도 포함될 수 있으며 해당 개체는 어떤 개체에 의해 루트가 지정되지 않았지만 가비지 수집기에 의해 아직 수집되지 않은 개체입니다.

요구 사항

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

헤더: CorDebug.idl, CorDebug.h

라이브러리: CorGuids.lib

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

참고 항목