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 |