在 Exchange 中处理 EWS 中与同步相关的错误

了解如何在 Exchange 中使用 EWS 托管 API 或 EWS 开发的应用程序中处理与同步相关的错误。

如果应用程序同步项和文件夹,则可能必须处理与同步相关的错误。 您可以处理这些错误在运行时,或者开发 EWS 应用程序时。 其中大多数错误由 EWS 托管 API 中的 ResponseCodeType 枚举定义,Exchange Web Services 中的 ResponseCode 元素 (EWS) 。

表 1. 与同步相关的错误及其处理方法

错误 尝试... 处理它的...
ErrorInvalidSyncStateData
使用无效的同步状态值同步项目或文件夹。
如果后续请求包含根文件夹,则排除初始 SyncFolderHierarchy 请求中的根文件夹。
在后续请求中使用不同的根文件夹。
确保发送的同步状态值与先前同步期间返回的同步状态值匹配。
确保在尝试同步项目时不发送文件夹层次结构的同步状态,反之亦然。
确保发送正确的根文件夹的同步状态。
确保在每个请求中指定相同的根文件夹。
确保上一个请求未指定 null 的根文件夹,而当前请求包含根文件夹。 Null 和 root 的处理不相同。
ErrorSyncFolderNotFound
同步在服务器上找不到的文件夹中的子文件夹或项目。
确保请求中指定的文件夹 ID 与在以前的同步响应中从服务器返回的文件夹 ID 匹配。
ErrorTimeoutExpired
发送过多的请求。
将批限制为每个批 10 个项,以避免 受到限制
ServiceResponseException
当服务器脱机或连接出现问题时,连接到 EWS。
检查与服务器的连接,并稍后重试请求。 这可能是暂时性服务错误或网络错误。

另请参阅