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 で、 x は dwparamID で指定された値の整数部分と一致します。
[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 |