参考来源与致谢
- 引用来源:OAB Downloads fail with 0x80190197 – Dgoldman's WebLog – Site Home – MSDN Blogs
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内 Outlook 客户端通过 Web 分发方式下载脱机通讯簿(OAB)时失败,客户端或日志中出现错误码 0x80190197。该错误在十六进制下对应 BG_E_HTTP_ERROR_407,本质是 HTTP 407 代理认证问题。常见于客户端所在网络使用代理服务器、代理配置脚本或自动配置,且代理要求集成 Windows 认证的环境。
Outlook 在建立连接时会通过 Windows API 读取 Windows 客户端的 Internet Explorer 代理设置。若代理设置指向不可用或不可访问的代理,连接可能失败。需注意:Outlook 一旦按代理配置尝试连接失败,通常不会自动改为直连。
准备与风险 #
- 确认受影响范围:单台客户端、某个子网还是整个站点。
- 准备测试环境,先在单台非关键客户端复现并验证,再推广到批量。
- 修改注册表或组策略前,先导出相关注册表分支或记录当前策略值,便于回退。
- 涉及注册表路径
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlLsaLmCompatibilityLevel时,改动可能影响认证兼容性,须评估后再操作。 - 不要在未备份的情况下批量下发策略或删除代理配置。
处理步骤 #
方向一:检查代理配置 #
- 确认客户端使用的代理服务器处于运行状态且网络可达。
- 检查组策略或 IEAK 下发的代理设置,确认没有指向失效的代理地址或错误的配置脚本。
- 在客户端上用 Internet Explorer 访问 Outlook 尝试连接的同一 URL,确认能否正常连通。
- 若确认代理配置有误,修正策略后刷新客户端策略并重试。
方向二:检查 BITS 相关条件 #
使用 BITS 传输时也可能出现同一错误码。当以下条件同时成立时容易触发:调用方未通过 IBackgroundCopyJob2::SetCredentials 指定可使用客户端凭据;客户端 LmCompatibilityLevel 值为 0 或 1;文件传输经过要求集成 Windows 认证的服务器或代理。
此时可参考对应版本的官方文档调整行为,例如通过注册表项改变相关设置。具体键值与适用范围请查阅对应版本的官方文档,不要凭经验直接套用。
验证方法 #
- 在测试客户端手动触发 OAB 下载,观察是否仍返回
0x80190197。 - 查看客户端与服务器相关日志,确认错误码是否消失。
- 确认 OAB 文件已更新到本地缓存目录,且版本符合预期。
- 在多台不同子网客户端上抽样验证,排除单点网络问题。
回退建议 #
- 若修改注册表后问题未解决或引入新问题,恢复此前导出的注册表值。
- 若调整了组策略,恢复原策略设置并重新刷新客户端。
- 回退后重新验证 OAB 下载与客户端连接状态,确认恢复原状。
常见问题 #
- 问:为什么代理不可用会导致 OAB 下载失败?答:Outlook 按 IE 代理设置尝试连接,失败后不会自动直连。
- 问:关闭代理是否可行?答:可作为临时验证手段,但通常不是理想长期方案,应优先修正代理配置或认证条件。
- 问:错误码含义是什么?答:
0x80190197对应 HTTP 407,即代理认证问题。 - 问:如何确认是否与 BITS 有关?答:结合客户端 BITS 使用情况、
LmCompatibilityLevel取值及代理认证要求综合判断,必要时查阅对应版本官方文档。
提示:不同 Exchange 与 Outlook 版本行为可能存在差异,涉及注册表、组策略或认证设置时,请以对应版本的官方文档为准。
