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 |