ホーム › System.ErrorReporting › PFN_WER_RUNTIME_EXCEPTION_EVENT

PFN_WER_RUNTIME_EXCEPTION_EVENT

コールバック

シグネチャ

HRESULT PFN_WER_RUNTIME_EXCEPTION_EVENT(
    void* pContext,
    WER_RUNTIME_EXCEPTION_INFORMATION* pExceptionInformation,
    BOOL* pbOwnershipClaimed,
    LPWSTR pwszEventName,
    DWORD* pchSize,
    DWORD* pdwSignatureCount
);

パラメーター

フィールド	型	説明
pContext	void*	例外ハンドラーを登録するために WerRegisterRuntimeExceptionModule 関数を呼び出したときに指定した、任意のコンテキスト情報へのポインター。
pExceptionInformation	WER_RUNTIME_EXCEPTION_INFORMATION*	例外情報を格納する WER_RUNTIME_EXCEPTION_INFORMATION 構造体。この情報を使用して、クラッシュの処理を引き受けるかどうかを判断します。
pbOwnershipClaimed	BOOL*	例外ハンドラーがこのクラッシュの処理を引き受ける場合は TRUE を、そうでない場合は FALSE を設定します。このパラメーターに FALSE を設定する場合は、残りの出力パラメーターを設定しないでください。
pwszEventName	LPWSTR	このクラッシュを識別するために使用するイベント名を指定するための、呼び出し元が割り当てたバッファー。
pchSize	DWORD*	pwszEventName バッファーのサイズ (文字数)。バッファーは MAX_PATH 文字に制限されます。このサイズには null 終端文字が含まれます。
pdwSignatureCount	DWORD*	指定するレポートパラメーターの数。有効な値の範囲は 1 から 10 です。10 より大きい値を指定した場合、WER はその値を無視し、最初の 10 個のパラメーターのみを収集します。0 を指定した場合、レポート処理は不定になります。この値は、WER が OutOfProcessExceptionEventSignatureCallback 関数を呼び出す回数を決定します。

公式ドキュメント

Windows Error Reporting (WER) は、例外ハンドラーがこのクラッシュの処理を引き受けるかどうかを判断するために、この関数を呼び出します。

PFN_WER_RUNTIME_EXCEPTION_EVENT 型は、このコールバック関数へのポインターを定義します。コールバック関数の名前には "OutOfProcessExceptionEventCallback" を使用する必要があります。

戻り値

例外ハンドラーがこのクラッシュの処理を引き受けない場合でも、S_OK を返してください。それ以外の失敗コードを返した場合、他のハンドラーが登録されていなければ、WER は既定のクラッシュ報告動作に戻ります。

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)