PFN_WER_RUNTIME_EXCEPTION_EVENT callback function

WER calls this function to determine whether the exception handler is claiming the crash.

The PFN_WER_RUNTIME_EXCEPTION_EVENT type defines a pointer to this callback function. You must use "OutOfProcessExceptionEventCallback" as the name of the callback function.

Syntax

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

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

Parameters

pContext

A pointer to arbitrary context information that you specified when you called the WerRegisterRuntimeExceptionModule function to register the exception handler.

pExceptionInformation

A WER_RUNTIME_EXCEPTION_INFORMATION structure that contains the exception information. Use the information to determine whether you want to claim the crash.

pbOwnershipClaimed

pwszEventName

A caller-allocated buffer that you use to specify the event name used to identify this crash.

pchSize

The size, in characters, of the pwszEventName buffer. The buffer is limited to MAX_PATH characters. The size includes the null-terminating character.

pdwSignatureCount

The number of report parameters that you will provide. The valid range of values is one to 10. If you specify a value greater than 10, WER will ignore the value and collect only the first 10 parameters. If you specify zero, the reporting process will be indeterminate.

This value determines the number of times that WER calls your OutOfProcessExceptionEventSignatureCallback function.

Return value

Return S_OK, even if the exception handler is not claiming this crash. If you return other failure codes, WER reverts to its default crash reporting behavior if no other handlers are registered.

Remarks

You must implement this function in your exception handler DLL.

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header werapi.h

See also

WerRegisterRuntimeExceptionModule