ICLRErrorReportingManager::BeginCustomDump 메서드

오류 보고를 위해 사용자 지정 힙 덤프의 구성을 지정합니다.

HRESULT BeginCustomDump (
    [in] ECustomDumpFlavor dwFlavor,
    [in] DWORD dwNumItems,
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],
    DWORD dwReserved
);

매개 변수

  • dwFlavor
    [in] 사용자 지정 힙 덤프를 빌드할 때 기반으로 사용할 힙 덤프의 종류를 나타내는 ECustomDumpFlavor 값입니다.

  • dwNumItems
    [in] items 배열의 길이입니다. dwFlavor가 DUMP_FLAVOR_Mini가 아니면 dwNumItems는 0이어야 합니다.

  • items
    [in] 미니덤프에 추가할 항목이 지정되어 있는 CustomDumpItem 인스턴스의 배열입니다. dwFlavor가 DUMP_FLAVOR_Mini가 아니면 items는 null이어야 합니다.

  • dwReserved
    [in] 나중에 사용할 수 있도록 예약되어 있습니다.

반환 값

HRESULT

설명

S_OK

메서드가 성공적으로 반환했습니다.

HOST_E_CLRNOTAVAILABLE

CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.

HOST_E_TIMEOUT

호출 시간이 초과되었습니다.

HOST_E_NOT_OWNER

호출자가 잠금을 소유하고 있지 않습니다.

HOST_E_ABANDONED

차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.

E_FAIL

알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후에는 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.

설명

BeginCustomDump 메서드는 사용자 지정 힙 덤프 구성을 설정합니다. EndCustomDump 메서드는 사용자 지정 힙 덤프 구성을 지우고 연결된 상태를 해제합니다. 사용자 지정 힙 덤프가 완료된 후 호출되어야 합니다.

중요중요

EndCustomDump를 호출하지 못하면 메모리가 누수됩니다.

요구 사항

플랫폼: .NET Framework 시스템 요구 사항 참조

헤더: MSCorEE.h

라이브러리: MSCorEE.dll에 리소스로 포함됨

.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

참고 항목

참조

CustomDumpItem 구조체

ECustomDumpFlavor 열거형

ICLRErrorReportingManager 인터페이스