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 |