Функция WerRegisterAppLocalDump (werapi.h)

Регистрирует путь (относительно LocalFolder упаковаемого приложения), по которому должна быть сохранена копия дампа диагностической памяти, который отчеты об ошибках Windows (WER) собирает, когда один из процессов для приложения перестает отвечать на запросы.

Синтаксис

HRESULT WerRegisterAppLocalDump(
  [in] PCWSTR localAppDataRelativePath
);

Параметры

[in] localAppDataRelativePath

Путь относительно локального магазина приложений для вызывающего приложения. Здесь сохраняется копия дампа диагностической памяти, который wer собирает, когда один из процессов для приложения перестает отвечать на запросы. Максимальная длина этого относительного пути в символах составляет WER_MAX_LOCAL_DUMP_SUBPATH_LENGTH со значением 64. Эта максимальная длина включает символ завершения со значением NULL.

Возвращаемое значение

Эта функция возвращает S_OK об успешном выполнении или код ошибки при сбое, включая следующие коды ошибок.

Код возврата Описание
WER_E_INVALID_STATE Процесс не может хранить дамп памяти, или WER не может создать расположение для хранения дампа памяти.
E_INVALIDARG Параметр localAppDataRelativePath имеет значение NULL или длиннее 64 символов.

Комментарии

Упаковающее приложение вызывает WerRegisterAppLocalDump при запуске приложения, чтобы запросить копию дампа диагностической памяти, который собирает WER, если или когда один из процессов для приложения перестает отвечать на запросы.

WER не управляет хранилищем в расположении, которое указывает относительный путь, или числом дампов памяти, собранных для приложения.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1709 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2016 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header werapi.h
Библиотека Kernel32.lib
DLL KernelBase.dll

См. также раздел

Функция WerUnregisterAppLocalDump, отчеты об ошибках Windows