WerReportCreate 関数 (werapi.h)

  • [アーティクル]

アプリケーション イベントを記述するWindows エラー報告 (WER) レポートを作成します。

構文

HRESULT WerReportCreate(
  [in]           PCWSTR                  pwzEventType,
  [in]           WER_REPORT_TYPE         repType,
  [in, optional] PWER_REPORT_INFORMATION pReportInformation,
  [out]          HREPORT                 *phReportHandle
);

パラメーター

[in] pwzEventType

イベントの名前を指定する Unicode 文字列へのポインター。

[in] repType

レポートの種類。 このパラメーターには、 WER_REPORT_TYPE 列挙型の次のいずれかの値を指定できます。

値 意味
WerReportApplicationCrash
2		 アプリケーションの実行を停止する原因となったエラーが発生しました。
WerReportApplicationHang
3		 アプリケーションが応答を停止する原因となったエラーが発生しました。
WerReportInvalid
5		 無効な戻り値を呼び出したエラーが発生しました。
WerReportKernel
4		 カーネルでエラーが発生しました。
WerReportCritical
1		 クラッシュや非応答などの重大なエラーが発生しました。 既定では、重大なエラーが発生したプロセスは終了または再起動されます。
WerReportNonCritical
0		 重大ではないエラーが発生しました。 この種類のレポートには UI が表示されません。レポートはサイレント キューに入れられます。 適切なユーザーの同意が得られる場合は、バックグラウンドでサーバーにサイレントに送信される場合があります。

[in, optional] pReportInformation

レポートの情報を指定する WER_REPORT_INFORMATION 構造体へのポインター。

[out] phReportHandle

レポートのハンドル。 関数が失敗した場合、このハンドルは NULL です。

戻り値

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

注釈

送信する追加情報を指定するには、次の関数を使用します。

情報を送信するには、 WerReportSubmit 関数を 呼び出します。 レポート ハンドルが完了したら、 WerReportCloseHandle 関数を呼び出します。

また、アプリケーションは、障害発生時にデータを回復または再起動する機会を望んでいることを示すこともできます。 詳細については、「アプリケーションの 回復と再起動」を参照してください。

アプリケーションによって送信されたレポートを表示するには、Windows Quality Online Services に移動します。

要件

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

こちらもご覧ください

アプリケーションの回復と再起動、WER_REPORT_INFORMATION、WerReportCloseHandle、WerReportSubmit、Windows エラー報告