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
此參數可以是下列一或多個值。
| 值 | 意義 |
|---|---|
| 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 |
僅封存參數;會捨棄 cab。 此旗標會覆寫 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 |
| 程式庫 | Wer.lib |
| Dll | Wer.dll |
另請參閱
Application Recovery and Restart、WerReportCreate、Windows 錯誤報告