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

Статья
07/27/2023

Добавляет файл в указанный отчет отчеты об ошибках Windows (WER).

Синтаксис

HRESULT WerReportAddFile(
  [in] HREPORT       hReportHandle,
  [in] PCWSTR        pwzPath,
  [in] WER_FILE_TYPE repFileType,
  [in] DWORD         dwFileFlags
);

Параметры

[in] hReportHandle

Дескриптор отчета. Этот дескриптор возвращается функцией WerReportCreate .

[in] pwzPath

Указатель на строку Юникода, содержащую полный путь к добавляемого файла. Этот путь может использовать переменные среды. Максимальная длина этого пути составляет MAX_PATH символов.

[in] repFileType

Тип файла. Этот параметр может быть одним из следующих значений из типа перечисления WER_FILE_TYPE .

Значение	Значение
WerFileTypeHeapdump	Расширенный минидамп, содержащий дополнительные данные, такие как память процесса.
WerFileTypeMicrodump	Ограниченный минидамп, содержащий только трассировку стека.
WerFileTypeMinidump	Файл minidump.
WerFileTypeДругие	Любой другой тип файла. Этот файл всегда добавляется в cab-файл (но только в том случае, если сервер запрашивает cab-файл).
WerFileTypeUserDocument	Документ, используемый приложением во время события. Документ добавляется, только если сервер запрашивает документ этого типа.

[in] dwFileFlags

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

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

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

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

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Указанный файл не существует.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Указанный файл является пользовательским документом и хранится в зашифрованной файловой системе; Это сочетание не поддерживается.

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

Требования

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

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

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