WerRegisterFile 関数 (werapi.h)

  • [アーティクル]

Windows エラー報告 (WER) がエラー レポートを作成するときに収集するファイルを登録します。

構文

HRESULT WerRegisterFile(
  [in] PCWSTR                 pwzFile,
  [in] WER_REGISTER_FILE_TYPE regFileType,
  [in] DWORD                  dwFlags
);

パラメーター

[in] pwzFile

ファイルへの完全なパスです。 このパスの最大長はMAX_PATH文字です。

[in] regFileType

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

値 意味
WerRegFileTypeMax
3 WER_REGISTER_FILE_TYPE列挙型の最大値。
WerRegFileTypeOther
2 その他の種類のファイル。
WerRegFileTypeUserDocument
1 イベントの発生時にアプリケーションによって使用されているドキュメント。 このドキュメントは、Watson サーバーから要求された場合にのみ収集されます。

[in] dwFlags

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

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

戻り値

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

リターン コード 説明
WER_E_INVALID_STATE プロセスの状態が無効です。 たとえば、プロセスはアプリケーション回復モードです。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) 登録されているメモリ ブロックとファイルの数が制限を超えています。

注釈

登録済みファイルは、サーバーによって追加データが要求された場合にのみ、レポートに追加されます。

クラッシュと応答以外の場合、オペレーティング システムは自動的にエラー報告を提供します (アプリケーションでエラー報告コードを指定する必要はありません)。 この関数を使用してファイルを登録すると、オペレーティング システムは、クラッシュ時または非応答時に作成されたエラー レポートにファイルを追加します (このファイルは、オペレーティング システムが既に収集しているファイルに加えて追加されます)。

汎用イベント レポートの場合、アプリケーションでは代わりに WerReportAddFile 関数を使用する必要があります。 または、WER_SUBMIT_ADD_REGISTERED_DATA フラグを指定して WerReportSubmit 関数を呼び出すと、 WerRegisterFile 関数が追加したファイルが含まれます。

リストからファイルを削除するには、 WerUnregisterFile 関数を呼び出します。

要件

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

関連項目

WerUnregisterFile、Windows エラー報告