ICorDebugProcess5::EnumerateHeap 메서드

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

Syntax

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

매개 변수

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

비고

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

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

요구 사항

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

머리글: CorDebug.idl, CorDebug.h

도서관: CorGuids.lib

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

참고하십시오

• ICorDebugProcess5 인터페이스