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