PreviousWatermark
Das PreviousWatermark-Element stellt das Wasserzeichen des letzten Ereignisses dar, das dem Client für das Abonnement erfolgreich mitgeteilt wurde.
<PreviousWatermark/>
WatermarkType
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
Keine.
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
| Element | Beschreibung |
|---|---|
|
Benachrichtigung |
Enthält Informationen zum Abonnement und zu den Ereignissen, die seit der letzten Benachrichtigung aufgetreten sind. |
Textwert
Ein Textwert ist erforderlich. Der Textwert stellt das neueste Wasserzeichen dar. Der Textwert darf keine leere Zeichenfolge sein.
Hinweise
Die PreviousWatermark-Eigenschaft ist für den Client nützlich, um die letzte erfolgreiche Benachrichtigung zu bestimmen. Wenn ein Abonnement beispielsweise drei Ereignisse mit den Wasserzeichen 1, 2 und 3 aufweist und die nächste Benachrichtigung mit dem Wert PreviousWatermark von 3 gesendet wird, kann der Client diesen Wert mit dem Wasserzeichenwert der letzten empfangenen Benachrichtigung vergleichen. Dadurch kann der Client die Kontinuität von Ereignissen sicherstellen.
Bei Pushclients wird previousWatermark mit dem lokalen, clientseitigen letzten bekannten Wasserzeichen verglichen. Wenn sich die Werte unterscheiden, hat der Client eine Ereignisbenachrichtigung verpasst und sollte ein Abonnement mithilfe des neuesten lokalen Wasserzeichens wiederherstellen. Wenn ein Pushclient beispielsweise drei Ereignisse für ein Abonnement mit den Wasserzeichen 1, 2 und 3 empfängt und die nächste Benachrichtigung den Wert PreviousWatermark von 5 aufweist, hat der Client mindestens eine Benachrichtigung verpasst und sollte ein neues Abonnement erstellen und eine 3 als Wasserzeichen übergeben.
Im Fall eines Pullclients entspricht der Wert von PreviousWatermark dem Wasserzeichen , das vom Client im GetEvents-Aufruf enthalten ist.
Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der Microsoft Exchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.
Informationen zu Elementen
| Name | Wert |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
| Name des Schemas |
Schematypen |
| Überprüfungsdatei |
Types.xsd |
| Leer kann sein |
False |