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 函数。或者，使用 WER_SUBMIT_ADD_REGISTERED_DATA 标志调用 WerReportSubmit 函数将包括 WerRegisterFile 函数添加的文件。

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