Функция 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

Этот параметр может иметь одно или несколько из следующих значений.

Значение Значение
WER_FILE_ANONYMOUS_DATA Файл не содержит личных сведений, которые можно использовать для идентификации пользователя или связи с ним.
WER_FILE_DELETE_WHEN_DONE Автоматически удаляет файл после его добавления в отчет.

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

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

Код возврата Описание
WER_E_INVALID_STATE Недопустимое состояние процесса. Например, процесс находится в режиме восстановления приложения.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) Количество зарегистрированных блоков памяти и файлов превышает ограничение.

Комментарии

Зарегистрированный файл добавляется в отчет только в том случае, если сервер запрашивает дополнительные данные.

В случае сбоев и неответов операционная система автоматически предоставляет отчеты об ошибках (вам не нужно предоставлять код отчета об ошибках в приложении). Если эта функция используется для регистрации файла, операционная система добавит файл в отчет об ошибках, созданный во время сбоя или неответа (этот файл добавляется в дополнение к файлам, которые уже собирает операционная система).

Для создания отчетов об универсальных событиях приложение может использовать функцию WerReportAddFile . Кроме того, вызов функции WerReportSubmit с флагом WER_SUBMIT_ADD_REGISTERED_DATA будет включать файлы, добавленные функцией WerRegisterFile .

Чтобы удалить файл из списка, вызовите функцию WerUnregisterFile .

Требования

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

См. также

WerUnregisterFile, отчеты об ошибках Windows