werRegisterFile 函数 (werapi.h)

注册在 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 枚举类型的以下值之一。

Value 含义
WerRegFileTypeMax
3
WER_REGISTER_FILE_TYPE枚举类型的最大值。
WerRegFileTypeOther
2
任何其他类型的文件。
WerRegFileTypeUserDocument
1
事件时应用程序正在使用的文档。 仅当 Watson 服务器要求它时,才会收集此文档。

[in] dwFlags

此参数可使用以下一个或多个值。

Value 含义
WER_FILE_ANONYMOUS_DATA
该文件不包含可用于标识或联系用户的个人信息。
WER_FILE_DELETE_WHEN_DONE
将文件添加到报表后自动删除该文件。

返回值

此函数返回 成功时S_OK 或失败时的错误代码,包括以下错误代码。

返回代码 说明
WER_E_INVALID_STATE
进程状态无效。 例如,该过程处于 应用程序恢复模式
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
已注册的内存块和文件数超过了限制。

注解

仅当服务器请求其他数据时,注册的文件才会添加到报表中。

对于崩溃和非响应,操作系统会自动提供错误报告 (无需在应用程序中提供任何错误报告代码) 。 如果使用此函数注册文件,则除了操作系统已收集的文件) 之外,还会将此文件添加到在崩溃或非响应时创建的错误报告 (。

对于泛型事件报告,应用程序必须改用 WerReportAddFile 函数。 或者,使用WER_SUBMIT_ADD_REGISTERED_DATA标志调用 WerReportSubmit 函数将包含 WerRegisterFile 函数添加的文件。

若要从列表中删除文件,请调用 WerUnregisterFile 函数。

要求

   
最低受支持的客户端 Windows Vista [桌面应用|UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用|UWP 应用]
目标平台 Windows
标头 werapi.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

WER 函数

WerUnregisterFile

Windows 错误报告