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 函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | werapi.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈