WerReportAddDump 関数 (werapi.h)

指定した型のダンプを、指定したWindows エラー報告 (WER) レポートに追加します。

構文

HRESULT WerReportAddDump(
  [in]           HREPORT                    hReportHandle,
  [in]           HANDLE                     hProcess,
  [in, optional] HANDLE                     hThread,
  [in]           WER_DUMP_TYPE              dumpType,
  [in, optional] PWER_EXCEPTION_INFORMATION pExceptionParam,
  [in, optional] PWER_DUMP_CUSTOM_OPTIONS   pDumpCustomOptions,
  [in]           DWORD                      dwFlags
);

パラメーター

[in] hReportHandle

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

[in] hProcess

レポートが生成されるプロセスのハンドル。 このハンドルには、STANDARD_RIGHTS_READとPROCESS_QUERY_INFORMATIONアクセス権が必要です。

[in, optional] hThread

レポートが生成される hProcess のスレッドへのハンドル。 dumpType が WerDumpTypeMicro の場合、このパラメーターは必須です。 その他のダンプの種類の場合、このパラメーターは NULL である可能性があります。

[in] dumpType

ミニダンプの種類。 このパラメーターには、 WER_DUMP_TYPE 列挙型の次のいずれかの値を指定できます。

[in, optional] pExceptionParam

例外情報を指定 するWER_EXCEPTION_INFORMATION 構造体へのポインター。

[in, optional] pDumpCustomOptions

カスタム ミニダンプ オプションを指定する WER_DUMP_CUSTOM_OPTIONS 構造体へのポインター。 このパラメーターが NULL の場合、標準のミニダンプ情報が収集されます。

[in] dwFlags

このパラメーターには、0 または次の値を指定できます。

戻り値

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

注釈

この関数は、一般的なレポートにのみ使用します。オペレーティング システムのクラッシュや応答なしレポートには影響しません。

サーバーがミニ ダンプを要求し、dumpType パラメーターに WerDumpTypeHeapDump を指定した場合、WER はヒープ ダンプを Watson サーバーに送信しません。 ただし、サーバーがヒープ ダンプを要求し、 dumpType が WerDumpTypeMiniDump の場合、WER はミニ ダンプをサーバーに送信します。 したがって、 dumpType を WerDumpTypeMiniDump に設定することをお勧めします。

要件

こちらもご覧ください

ミニダンプ ファイル、WER_DUMP_CUSTOM_OPTIONS、WER_EXCEPTION_INFORMATION、WerReportCreate、Windows エラー報告