WerReportAddFile 関数 (werapi.h)

  • [アーティクル]

指定したWindows エラー報告 (WER) レポートにファイルを追加します。

構文

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

パラメーター

[in] hReportHandle

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

[in] pwzPath

追加するファイルへの完全なパスを含む Unicode 文字列へのポインター。 このパスでは環境変数を使用できます。 このパスの最大長はMAX_PATH文字です。

[in] repFileType

ファイルの種類。 このパラメーターには、 WER_FILE_TYPE 列挙型の次のいずれかの値を指定できます。

値 意味
WerFileTypeHeapdump プロセス メモリなどの追加データを含む拡張ミニダンプ。
WerFileTypeMicrodump スタック トレースのみを含む制限付きミニダンプ。
WerFileTypeMinidump ミニダンプ ファイル。
WerFileTypeOther その他の種類のファイル。 このファイルは常に cab に追加されます (ただし、サーバーが cab を要求した場合のみ)。
WerFileTypeUserDocument イベントの発生時にアプリケーションによって使用されているドキュメント。 ドキュメントは、サーバーがこの種類のドキュメントを要求する場合にのみ追加されます。

[in] dwFileFlags

このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
WER_FILE_ANONYMOUS_DATA このファイルには、ユーザーを識別または連絡するために使用できる個人情報は含まれていません。
WER_FILE_DELETE_WHEN_DONE レポートの送信後にファイルを自動的に削除します。

戻り値

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

リターン コード 説明
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 指定したファイルが存在しません。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) 指定されたファイルはユーザー ドキュメントであり、暗号化されたファイル システムに格納されます。この組み合わせはサポートされていません。

注釈

この関数を使用して (特定のフラグを使用して) メモリ ダンプをエラー レポートに追加することもできますが、メモリ ダンプの追加に使用する推奨される関数は WerReportAddDump です。 この関数は、ダンプを自分で収集してからレポートに追加する場合にのみ使用する必要があります。

要件

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

こちらもご覧ください

WerReportCreate、Windows エラー報告