WerReportSetParameter 関数 (werapi.h)

指定したWindows エラー報告 (WER) レポートのイベントを一意に識別するパラメーターを設定します。

構文

HRESULT WerReportSetParameter(
  [in]           HREPORT hReportHandle,
  [in]           DWORD   dwparamID,
  [in, optional] PCWSTR  pwzName,
  [in]           PCWSTR  pwzValue
);

パラメーター

[in] hReportHandle

レポートのハンドル。 このハンドルは、 WerReportCreate 関数によって返されます。

[in] dwparamID

設定するパラメーターの識別子。 このパラメーターには、次の値のいずれかを指定できます。

  • WER_P0
  • WER_P1
  • WER_P2
  • WER_P3
  • WER_P4
  • WER_P5
  • WER_P6
  • WER_P7
  • WER_P8
  • WER_P9

[in, optional] pwzName

パラメーターの名前を含む Unicode 文字列へのポインター。 このパラメーターが NULL の場合、既定の名前は Px で、 xdwparamID で指定された値の整数部分と一致します。

[in] pwzValue

パラメーター値。

戻り値

この関数は、成功した 場合はS_OK を返し、失敗した場合は次のエラー コードを含むエラー コードを返します。

リターン コード 説明
E_HANDLE 指定されたハンドルが無効です。
WER_E_LENGTH_EXCEEDED 1 つ以上の文字列引数の長さが制限を超えています。

解説

各レポートでは、パラメーター P0 から P9 がサポートされます。 この関数は、一度に 1 つのパラメーターを設定します。 パラメーター Px が設定されている場合は、P0 と P x のすべてのパラメーター 設定する必要があります。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー werapi.h
Library Wer.lib
[DLL] Wer.dll

関連項目

WerReportCreateWindows エラー報告