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 |