PreviousWatermark

  • [アーティクル]

PreviousWatermark 要素は、サブスクリプションのクライアントに正常に通信された最新のイベントの透かしを表します。

<PreviousWatermark/>

WatermarkType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

なし。

子要素

なし。

親要素

要素 説明
通知
サブスクリプションと、前回の通知以降に発生したイベントに関する情報が含まれます。

テキスト値

テキスト値は必須です。 テキスト値は、最新の透かしを表します。 テキスト値を空の文字列にすることはできません。

注釈

PreviousWatermark プロパティは、最後に成功した通知を決定する際にクライアントに役立ちます。 たとえば、サブスクリプションに透かし 1、2、3 の 3 つのイベントがあり、次の通知が PreviousWatermark 値 3 で送信された場合、クライアントはこの値を最後に受信した通知の透かし値と比較できます。 これにより、クライアントはイベントの継続性を確保できます。

プッシュ クライアントの場合、 PreviousWatermark はローカルのクライアント側の最後の既知の透かしと比較されます。 値が異なる場合、クライアントはイベント通知を見逃しており、最新のローカル透かしを使用してサブスクリプションを再確立する必要があります。 たとえば、プッシュ クライアントが透かし 1、2、3 のサブスクリプションに対して 3 つのイベントを受け取り、次の通知に PreviousWatermark 値が 5 である場合、クライアントは少なくとも 1 つの通知を見逃しており、透かしとして 3 を渡す新しいサブスクリプションを作成する必要があります。

プル クライアントの場合、 PreviousWatermark の値は、GetEvents 呼び出しにクライアントに含まれる 透かし と同じになります。

この要素を記述するスキーマは、クライアント アクセス サーバーの役割がインストールされている 2007 Microsoft Exchange Server実行されているコンピューターの EWS 仮想ディレクトリにあります。

要素の情報

名前 Value
Namespace
 http://schemas.microsoft.com/exchange/services/2006/types
スキーマ名
 型スキーマ
検証ファイル
 Types.xsd
空に設定可能
 False

関連項目

サブスクライブ操作

GetEvents 操作

Unsubscribe 操作