WerReportHang 函式 (errorrep.h)
在指定的視窗上起始「無回應」報告。
語法
HRESULT WerReportHang(
[in] HWND hwndHungApp,
[in, optional] PCWSTR pwzHungApplicationName
);
參數
[in] hwndHungApp
未回應之視窗的控制碼。
[in, optional] pwzHungApplicationName
要顯示在 Hang Reporting UI 中的未回應應用程式名稱。 名稱限制為 128 個字元,包括 Null 結束字元。 如果 為 Null,WER 會嘗試從目標映射資源取得名稱。 如果無法從映射取得名稱,則會使用映射名稱。
傳回值
如果函式能夠在失敗時起始報告或錯誤碼,則傳回S_OK。 請注意,S_OK不一定表示「沒有回應」報告已成功完成,只表示它已起始。
備註
謹慎 應用程式不應該使用此 API 來報告來自最上層視窗的回應;Windows XP 和更新版本的所有最上層視窗預設皆可使用無回應偵測和報告。 您應該只使用此函式來報告子視窗沒有回應。 一般而言,只有在最上層視窗及其子視窗由不同進程擁有,而且子視窗中偵測到非回應時,才會使用此函式。
此函式是非同步;它不會等候無回應報告完成。 在啟動回應報告之後,沒有任何方法可以取消回應報告。
如果您使用此函式,請務必遵守下列需求:
- 確定子視窗是由個別進程所建立。 在無回應報告完成之後,它會終止建立視窗的程式。
- 在子視窗中提供未回應的視覺線索;無回應報告不會將子視窗變暗,它只會顯示報告對話方塊。
- 確認使用者想要在呼叫此函式之前終止未回應的子視窗。
- 為了讓沒有回應的報告 UI 出現在未回應的視窗前面,應用程式應該從最上層視窗的處理常式呼叫 AllowSetForegroundWindow (傳遞進程識別碼ASFW_ANY) 函式。
需求
最低支援的用戶端 | 具有 SP1 的 Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | errorrep.h |
程式庫 | Faultrep.lib |
Dll | Faultrep.dll |