WerReportSubmit 関数 (werapi.h)

  • [アーティクル]

指定したWindows エラー報告 (WER) レポートを送信します。

構文

HRESULT WerReportSubmit(
  [in]            HREPORT            hReportHandle,
  [in]            WER_CONSENT        consent,
  [in]            DWORD              dwFlags,
  [out, optional] PWER_SUBMIT_RESULT pSubmitResult
);

パラメーター

[in] hReportHandle

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

[in] consent

同意の状態。 このパラメーターには、 WER_CONSENT 列挙型の次のいずれかの値を指定できます。

値 意味
WerConsentAlwaysPrompt
4		 ユーザーは常に要求の送信を求められます。
WerConsentApproved
2		 ユーザーが申請要求を承認しました。
WerConsentDenied
3		 ユーザーが申請要求を拒否しました。
WerConsentMax
5		 WER_CONSENT列挙型の最大値。
WerConsentNotAsked
1		 ユーザーに同意を求められなかった。

[in] dwFlags

このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
WER_SUBMIT_ADD_REGISTERED_DATA
16		 WerSetFlags、WerRegisterFile、WerRegisterMemoryBlock によって登録されたデータをレポートに追加します。
WER_SUBMIT_HONOR_RECOVERY
1		 アプリケーションの復旧登録を受け入れられます。 詳細については、「 RegisterApplicationRecoveryCallback」を参照してください。
WER_SUBMIT_HONOR_RESTART
2		 アプリケーションの再起動登録を優先します。 詳細については、「 RegisterApplicationRestart」を参照してください。
WER_SUBMIT_NO_ARCHIVE
256		 レポートをアーカイブしないでください。
WER_SUBMIT_NO_CLOSE_UI
64		 クリティカル レポートの閉じるダイアログ ボックスは表示しません。
WER_SUBMIT_NO_QUEUE
128		 レポートをキューに登録しないでください。 適切なユーザーの同意がある場合、レポートは直ちに Microsoft に送信されます。それ以外の場合、レポートは破棄されます。 このフラグは、重要でないレポートに使用できます。

レポートは、レポートをキューに登録する必要があるアクションに対して破棄されます。 たとえば、レポートを送信するときにコンピューターがオフラインの場合、レポートは破棄されます。 また、不十分な同意がある場合 (たとえば、レポートのデータ部分に同意が必要でした)、レポートは破棄されます。
WER_SUBMIT_OUTOFPROCESS
32		 レポートを送信する別のプロセスを生成します。 呼び出し元のスレッドは、関数が返されるまでブロックされます。

メモ： 呼び出し元スレッドの UI アクティビティがブロックされないように、ウィンドウ メッセージがポンプされます。
WER_SUBMIT_OUTOFPROCESS_ASYNC
1024		 レポートを送信し、この関数呼び出しからすぐに戻る別のプロセスを生成します。 pSubmitResult パラメーターの内容は未定義であり、レポートが完了したときや完了状態になったときにクエリを実行する方法がないことに注意してください。
WER_SUBMIT_QUEUE
4		 ユーザーに通知せずに、レポートを WER キューに追加します。 レポートはキューにのみ登録されます。レポート (レポートを Microsoft に送信) は、ユーザーの同意レベルに基づいて後で行われます。
WER_SUBMIT_SHOW_DEBUG
8		 [デバッグ] ボタンを表示します。
WER_SUBMIT_START_MINIMIZED
512		 初期 UI は最小化され、点滅します。
WER_SUBMIT_BYPASS_DATA_THROTTLING
2048		 レポートのデータ調整をバイパスします。

Windows 7 以前: このパラメーターは使用できません。
WER_SUBMIT_ARCHIVE_PARAMETERS_ONLY
4096		 パラメーターのみをアーカイブします。タクシーは破棄されます。 このフラグは 、ConfigureArchive WER 設定をオーバーライドします。

Windows 7 以前: このパラメーターは使用できません。
WER_SUBMIT_REPORT_MACHINE_ID
8192		 レポートが送信された同意に関係なく、常に一意の 128 ビット コンピューター識別子をレポートと共に送信します。 詳細については、「解説」を参照してください。

Windows 7 以前: このパラメーターは使用できません。

[out, optional] pSubmitResult

送信の結果。 このパラメーターには、 WER_SUBMIT_RESULT 列挙型の次のいずれかの値を指定できます。

値 意味
WerCustomAction
9		 エラー報告はカスタマイズできます。
WerDisabled
5		 エラー報告が無効になりました。
WerDisabledQueue
7		 キューが無効になりました。
WerReportAsync
8		 レポートは非同期でした。
WerReportCancelled
6		 レポートが取り消されました。
WerReportDebug
3		 [デバッグ] ボタンがクリックされました。
WerReportFailed
4		 レポートの送信に失敗しました。
WerReportQueued
1		 レポートがキューに登録されました。
WerReportUploaded
2		 レポートがアップロードされました。

戻り値

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

注釈

アプリケーションがこの関数を呼び出した後、WER は指定されたデータを収集します。 同意パラメーターが WerConsentApproved の場合、レポートは Microsoft に送信されます。 同意が WerConsentNotAsked の場合、WER は同意ダイアログ ボックスを表示します。 送信の状態を確認するには、pSubmitResult パラメーターをチェックします。

重要なアプリケーション イベントが発生した場合、 再起動に登録されている アプリケーションが再起動されます。

コンピューター識別子は、次の場合にレポートと共に送信されます。

  • レポートの送信に使用される同意は、アプリケーションから取得されません。 たとえば、同意状態が WerConsentNotAsked に設定されたレポートが送信されました。
  • レポートは、WER_SUBMIT_REPORT_MACHINE_ID フラグが設定された状態で送信されました。

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

要件

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

こちらもご覧ください

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