다음을 통해 공유


ICLRDataTarget3::GetExceptionContextRecord 메서드

CLR(공용 언어 런타임) 데이터 액세스 서비스에 의해 호출되어 대상 프로세스와 연결된 컨텍스트 레코드를 검색합니다. 예를 들어, 덤프 대상의 경우, 이것은 Windows 디버그 도움말 라이브러리(DbgHelp)의 MiniDumpWriteDump 함수에 ExceptionParam 인수로 전달되는 컨텍스트 레코드와 동등합니다.

구문

HRESULT GetExceptionContextRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize)] BYTE* buffer
);

매개 변수

bufferSize [in] 입력 버퍼 크기(바이트)입니다. 컨텍스트 레코드를 포함할 수 있을 정도로 커야 합니다.

bufferUsed [out] 버퍼에 ULONG32 실제로 기록된 바이트 수를 받는 형식에 대한 포인터입니다.

buffer [out] 컨텍스트 레코드의 복사본을 받는 메모리 버퍼에 대한 포인터입니다. 예외 레코드는 CONTEXT 형식으로 반환됩니다.

Return Value

반환 값은 성공 시 S_OK이고 실패 시에는 오류 HRESULT 코드입니다. HRESULT 코드는 다음을 비롯한 여러 항목을 포함할 수 있습니다.

반환 코드 설명
S_OK 메서드가 정상적으로 실행되었습니다. 컨텍스트 레코드가 출력 버퍼에 복사되었습니다.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) 컨텍스트 레코드가 대상에 연결되지 않았습니다.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) 입력 버퍼 크기가 컨텍스트 레코드를 수용할 수 있을 정도로 크지 않습니다.

설명

CONTEXT는 Windows SDK에서 제공하는 헤더에 정의된 플랫폼 관련 구조입니다.

이 메서드는 디버깅 애플리케이션의 작성자가 구현합니다.

요구 사항

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

헤더: ClrData.idl, ClrData.h

라이브러리: CorGuids.lib

.NET Framework 버전: 2013년 11월 4.5.1로 업데이트 이후 사용 가능

참고 항목