WerReportHang 関数 (errorrep.h)

指定したウィンドウで "応答なし" レポートを開始します。

構文

HRESULT WerReportHang(
  [in]           HWND   hwndHungApp,
  [in, optional] PCWSTR pwzHungApplicationName
);

パラメーター

[in] hwndHungApp

応答していないウィンドウを処理します。

[in, optional] pwzHungApplicationName

ハング レポート UI に表示される応答しないアプリケーションの名前。 名前は、 NULL 終端記号を含む 128 文字に制限されます。 NULL の場合、WER はターゲット イメージ リソースから名前を取得しようとします。 イメージから名前を取得できない場合は、イメージ名が使用されます。

戻り値

関数がエラー時にレポートまたはエラー コードを開始できた場合は、S_OKを返します。 S_OKは、必ずしも "応答なし" レポートが正常に完了したことを意味するわけではなく、開始されたというだけであることに注意してください。

解説

この関数は非同期です。応答なしレポートが完了するまで待機しません。 応答なしレポートの開始後に取り消す方法はありません。

この関数を使用する場合は、次の要件に従うことが重要です。

• 子ウィンドウが別のプロセスによって作成されていることを確認します。 応答なしレポートが完了すると、ウィンドウを作成したプロセスが終了します。
• 応答していない視覚的な手がかりを子ウィンドウに提供します。応答なしレポートは子ウィンドウを暗くせず、レポート ダイアログ ボックスのみを表示します。
• この関数を呼び出す前に、応答していない子ウィンドウをユーザーが終了することを確認します。
• 応答しないウィンドウの前に応答なしレポート UI を表示するには、アプリケーションで最上位ウィンドウのプロセスから AllowSetForegroundWindow (プロセス識別子のASFW_ANYを渡す) 関数を呼び出す必要があります。

要件