PreviousWatermark

PreviousWatermark 元素表示已成功与订阅客户端通信的最新事件的水印。

<PreviousWatermark/>

WatermarkType

属性和元素

下面各部分介绍了属性、子元素和父元素。

Attributes

无。

子元素

无。

父元素

元素 说明
通知
包含有关订阅的信息以及自上次通知以来发生的事件。

文本值

文本值是必需的。 文本值表示最新的水印。 文本值不能是空字符串。

备注

PreviousWatermark 属性对于客户端确定最后一个成功的通知非常有用。 例如,如果订阅具有三个水印为 1、2 和 3 的事件,并且发送的下一个通知的 PreviousWatermark 值为 3,则客户端可以将此值与收到的最后一个通知的水印值进行比较。 这使客户端能够确保事件的连续性。

对于推送客户端, 将 PreviousWatermark 与本地客户端最后一个已知水印进行比较。 如果值不同,则客户端错过了事件通知,应使用最新的本地水印重新建立订阅。 例如,如果推送客户端收到水印为 1、2 和 3 的订阅的三个事件,而下一个通知具有 PreviousWatermark 值为 5,则客户端至少错过了一个通知,并且应创建新的订阅,传递 3 作为水印。

对于请求客户端, PreviousWatermark 的值将与 GetEvents 调用中的客户端包含 的水印 相同。

描述此元素的架构位于正在运行 Microsoft Exchange Server 2007 的计算机(已安装客户端访问服务器角色)的 EWS 虚拟目录中。

元素信息

名称
命名空间
http://schemas.microsoft.com/exchange/services/2006/types
架构名称
类型架构
验证文件
Types.xsd
可以为空
False

另请参阅

订阅操作

GetEvents 操作

Unsubscribe 操作