werReportAddFile 函数 (werapi.h)

将文件添加到指定的Windows 错误报告 (WER) 报表。

语法

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

参数

[in] hReportHandle

报表的句柄。 此句柄由 WerReportCreate 函数返回。

[in] pwzPath

指向 Unicode 字符串的指针,该字符串包含要添加的文件的完整路径。 此路径可以使用环境变量。 此路径的最大长度为MAX_PATH个字符。

[in] repFileType

文件类型。 此参数可以是 WER_FILE_TYPE 枚举类型的下列值之一。

含义
WerFileTypeHeapdump 包含其他数据(如进程内存)的扩展小型转储。
WerFileTypeMicrodump 仅包含堆栈跟踪的有限小型转储。
WerFileTypeMinidump 小型转储文件。
WerFileTypeOther 任何其他类型的文件。 此文件将始终添加到 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
标头 werapi.h
Library Wer.lib
DLL Wer.dll

另请参阅

WerReportCreate,Windows 错误报告