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 |