PFN_WER_RUNTIME_EXCEPTION_EVENT 콜백 함수(werapi.h)

WER(Windows 오류 보고)은 이 함수를 호출하여 예외 처리기가 충돌을 클레임하는지 여부를 확인합니다.

PFN_WER_RUNTIME_EXCEPTION_EVENT 형식은 이 콜백 함수에 대한 포인터를 정의합니다. 콜백 함수의 이름으로 "OutOfProcessExceptionEventCallback"을 사용해야 합니다.

구문

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

매개 변수

[in] pContext

예외 처리기를 등록하기 위해 WerRegisterRuntimeExceptionModule 함수를 호출할 때 지정한 임의 컨텍스트 정보에 대한 포인터입니다.

[in] pExceptionInformation

예외 정보를 포함하는 WER_RUNTIME_EXCEPTION_INFORMATION 구조체입니다. 정보를 사용하여 크래시 클레임 여부를 결정합니다.

[out] pbOwnershipClaimed

예외 처리기가 이 충돌을 클레임하는 경우 TRUE 로 설정합니다. 그렇지 않으면 FALSE입니다. 이 매개 변수를 FALSE로 설정하면 나머지 out 매개 변수를 설정하지 마세요.

[out] pwszEventName

이 충돌을 식별하는 데 사용되는 이벤트 이름을 지정하는 데 사용하는 호출자 할당 버퍼입니다.

[in, out] pchSize

pwszEventName 버퍼의 크기(문자)입니다. 버퍼는 MAX_PATH 문자로 제한됩니다. 크기에는 null 종료 문자가 포함됩니다.

[out] pdwSignatureCount

제공할 보고서 매개 변수의 수입니다. 유효한 값 범위는 1~10입니다. 10보다 큰 값을 지정하면 WER은 값을 무시하고 처음 10개 매개 변수만 수집합니다. 0을 지정하면 보고 프로세스가 확정되지 않습니다.

이 값은 WER이 OutOfProcessExceptionEventSignatureCallback 함수를 호출하는 횟수를 결정합니다.

반환 값

예외 처리기가 이 충돌을 클레임하지 않더라도 S_OK 반환합니다. 다른 오류 코드를 반환하는 경우 다른 처리기가 등록되지 않은 경우 WER은 기본 크래시 보고 동작으로 되돌려집니다.

설명

예외 처리기 DLL에서 이 함수를 구현해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	werapi.h

추가 정보

WerRegisterRuntimeExceptionModule, Windows 오류 보고