다음을 통해 공유

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] 향후 사용을 위해 예약되어 있습니다.

Return Value

HRESULT 설명
S_OK 메서드가 성공적으로 반환했습니다.
HOST_E_CLRNOTAVAILABLE CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태에 있습니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환한 후 CLR은 프로세스 내에서 더 이상 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

설명

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

중요

EndCustomDump 호출에 실패하면 메모리 누수가 발생합니다.

요구 사항

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

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

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

참고 항목