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

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

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 がこのコールバック関数を呼び出す回数を決定します。

要件

こちらもご覧ください

WerRegisterRuntimeExceptionModule、Windows エラー報告