PFN_WER_RUNTIME_EXCEPTION_EVENTコールバック関数 (werapi.h)

Windows エラー報告 (WER) はこの関数を呼び出して、例外ハンドラーがクラッシュを要求しているかどうかを判断します。

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] pwszEventName

このクラッシュを識別するために使用するイベント名を指定するために使用する呼び出し元によって割り当てられたバッファー。

[in, out] pchSize

pwszEventName バッファーのサイズ (文字単位)。 バッファーはMAX_PATH文字に制限されます。 サイズには、null 終端文字が含まれます。

[out] pdwSignatureCount

指定するレポート パラメーターの数。 有効な値の範囲は 1 から 10 です。 10 より大きい値を指定すると、WER はその値を無視し、最初の 10 個のパラメーターのみを収集します。 0 を指定すると、レポート 処理は不確定になります。

この値は、WER が OutOfProcessExceptionEventSignatureCallback 関数を呼び出す回数を決定します。

戻り値

例外ハンドラーがこのクラッシュを要求していない場合でも、 S_OKを返します。 他のエラー コードを返した場合、他のハンドラーが登録されていない場合、WER は既定のクラッシュ レポート動作に戻ります。

注釈

この関数は、例外ハンドラー DLL に実装する必要があります。

要件

こちらもご覧ください

WerRegisterRuntimeExceptionModule, Windows エラー報告