WerRegisterAppLocalDump 関数 (werapi.h)

アプリケーションのプロセスの 1 つが応答を停止したときにWindows エラー報告 (WER) によって収集される診断メモリ ダンプのコピーを保存するパス (パッケージ化されたアプリケーションの LocalFolder に対する相対パス) を登録します。

構文

HRESULT WerRegisterAppLocalDump(
  [in] PCWSTR localAppDataRelativePath
);

パラメーター

[in] localAppDataRelativePath

呼び出し元アプリケーションのローカル アプリ ストアに対する相対パス。 これは、アプリケーションのプロセスの 1 つが応答を停止したときに WER が収集する診断メモリ ダンプのコピーが保存される場所です。 この相対パスの最大文字数は WER_MAX_LOCAL_DUMP_SUBPATH_LENGTHで、値は 64 です。 この最大長には、null 終端文字が含まれます。

戻り値

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

リターン コード	説明
WER_E_INVALID_STATE	プロセスでメモリ ダンプを格納できないか、WER がメモリ ダンプを格納する場所を作成できません。
E_INVALIDARG	localAppDataRelativePath パラメーターが NULL であるか、64 文字を超えています。

注釈

パッケージ化されたアプリケーションは、アプリケーションの起動時に WerRegisterAppLocalDump を呼び出して、アプリケーションのプロセスの 1 つが応答を停止した場合に WER が収集する診断メモリ ダンプのコピーを要求します。

WER は、相対パスが指定する場所、またはアプリケーションに対して収集されるメモリ ダンプの数でストレージを管理しません。

要件

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

こちらもご覧ください

WerUnregisterAppLocalDump 関数、Windows エラー報告