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 列挙型の次のいずれかの値を指定できます。

値 意味
WerDumpTypeHeapDump
 プロセス メモリなどの追加データを含む拡張ミニダンプ。

この型は、次のオプションを使用してミニダンプを作成することと同じです。

  • MiniDumpWithDataSegs
  • MiniDumpWithProcessThreadData
  • MiniDumpWithHandleData
  • MiniDumpWithPrivateReadWriteMemory
  • MiniDumpWithUnloadedModules
  • MiniDumpWithFullMemoryInfo
  • MiniDumpWithThreadInfo (Windows 7 以降)
  • MiniDumpWithTokenInformation (Windows 7 以降)
  • MiniDumpWithPrivateWriteCopyMemory (Windows 7 以降)
WerDumpTypeMicroDump
 スタック トレースのみを含む制限付きミニダンプ。

この型は、次のオプションを使用してミニダンプを作成することと同じです。

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithoutOptionalData
WerDumpTypeMiniDump
 ミニダンプ。

この型は、次のオプションを使用してミニダンプを作成することと同じです。

  • MiniDumpWithDataSegs
  • MiniDumpWithUnloadedModules
  • MiniDumpWithProcessThreadData
  • MiniDumpWithTokenInformation (Windows 7 以降)

[in, optional] pExceptionParam

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

[in, optional] pDumpCustomOptions

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

[in] dwFlags

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

値 意味
WER_DUMP_NOHEAP_ONQUEUE
 レポートがキューに登録されている場合は、ヒープ ダンプを含めないでください。 このフラグを使用すると、ディスク領域が節約されます。

戻り値

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

注釈

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

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

要件

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

こちらもご覧ください

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