PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE 콜백 함수(werapi.h)

WER(Windows 오류 보고)은 이 함수를 호출하여 문제를 고유하게 설명하는 보고서 매개 변수를 가져옵니다.

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

구문

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

매개 변수

[in] pContext

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

[in] pExceptionInformation

예외 정보를 포함하는 WER_RUNTIME_EXCEPTION_INFORMATION 구조체입니다.

[in] dwIndex

보고서 매개 변수의 인덱스입니다. 유효한 값은 0~9입니다. 이 함수에 대한 첫 번째 호출은 인덱스 를 0으로 설정해야 하며, 각 연속 호출은 인덱스 값을 순차적으로 증가시켜야 합니다.

[out] pwszName

매개 변수 이름을 지정하는 데 사용하는 호출자 할당 버퍼입니다.

[in, out] pchName

pwszName 버퍼의 크기(문자)입니다. 크기에는 null 종료 문자가 포함됩니다.

[out] pwszValue

매개 변수 값을 지정하는 데 사용하는 호출자 할당 버퍼입니다.

[in, out] pchValue

pwszValue 버퍼의 크기(문자 단위)입니다. 크기에는 null 종료 문자가 포함됩니다.

반환 값

성공에 대한 S_OK 반환합니다. 다른 오류 코드를 반환하는 경우 WER은 기본 크래시 보고 동작으로 되돌아갑니다.

설명

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

애플리케이션 관련 문제에 대한 오류 보고서를 생성하려면 애플리케이션에서 보고서 매개 변수라는 몇 가지 기본 정보를 사용하여 문제에 대한 간단한 설명을 만들어야 합니다. 보고서 매개 변수에는 애플리케이션 이름, 애플리케이션 버전, 모듈 이름, 모듈 버전 및 오류 코드와 같은 정보가 포함됩니다. 이러한 보고서 매개 변수의 조합은 고유한 문제를 설명합니다.

WER은 OutOfProcessExceptionEventCallback 콜백 함수의 pbOwnershipClaimed 매개 변수를 TRUE로 설정한 경우에만 이 콜백 함수를 호출합니다. OutOfProcessExceptionEventCallback의 pdwSignatureCount 매개 변수는 WER이 이 콜백 함수를 호출하는 횟수를 결정합니다.

요구 사항

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

추가 정보

WerRegisterRuntimeExceptionModule, Windows 오류 보고