ホーム › System.ErrorReporting › PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE

コールバック

シグネチャ

HRESULT PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE(
    void* pContext,
    WER_RUNTIME_EXCEPTION_INFORMATION* pExceptionInformation,
    DWORD dwIndex,
    LPWSTR pwszName,
    DWORD* pchName,
    LPWSTR pwszValue,
    DWORD* pchValue
);

パラメーター

フィールド	型	説明
pContext	void*	例外ハンドラーを登録するために WerRegisterRuntimeExceptionModule 関数を呼び出したときに指定した、任意のコンテキスト情報へのポインターです。
pExceptionInformation	WER_RUNTIME_EXCEPTION_INFORMATION*	例外情報を格納する WER_RUNTIME_EXCEPTION_INFORMATION 構造体です。
dwIndex	DWORD	レポートパラメーターのインデックスです。有効な値は 0 から 9 です。この関数の最初の呼び出しではインデックスを 0 に設定し、以降の呼び出しではインデックス値を順に 1 ずつ増やす必要があります。
pwszName	LPWSTR	パラメーター名を指定するために使用する、呼び出し元が割り当てたバッファーです。
pchName	DWORD*	pwszName バッファーのサイズ (文字数) です。このサイズには null 終端文字が含まれます。
pwszValue	LPWSTR	パラメーター値を指定するために使用する、呼び出し元が割り当てたバッファーです。
pchValue	DWORD*	pwszValue バッファーのサイズ (文字数) です。このサイズには null 終端文字が含まれます。

公式ドキュメント

Windows エラー報告 (WER) は、問題を一意に特定するレポートパラメーターを取得するために、この関数を呼び出します。

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

戻り値

成功した場合は S_OK を返します。それ以外の失敗コードを返した場合、WER は既定のクラッシュレポート動作に戻ります。

解説(Remarks)

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

アプリケーション固有の問題に対するエラーレポートを生成するには、アプリケーションはレポートパラメーターと呼ばれるいくつかの基本的な情報を使用して、問題の短い説明を作成する必要があります。レポートパラメーターには、アプリケーション名、アプリケーションのバージョン、モジュール名、モジュールのバージョン、エラーコードなどの情報が含まれます。これらのレポートパラメーターの組み合わせが、一意の問題を表します。

WER がこのコールバック関数を呼び出すのは、OutOfProcessExceptionEventCallback コールバック関数の pbOwnershipClaimed パラメーターを TRUE に設定した場合のみです。WER がこのコールバック関数を呼び出す回数は、OutOfProcessExceptionEventCallback の pdwSignatureCount パラメーターによって決まります。

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