IReplicaMetadata::GetChangeBatch
同期先プロバイダーからの指定したナレッジに含まれていない項目の項目メタデータが含まれた変更バッチを取得します。
HRESULT GetChangeBatch(
DWORD dwBatchSize,
ISyncKnowledge *pSyncKnowledge,
ISyncChangeBatch ** ppSyncChangeBatch);
パラメーター
- dwBatchSize
[in] 作成されるバッチのサイズ。
- pSyncKnowledge
[in] 同期先プロバイダーからのナレッジ。
- ppSyncChangeBatch
[out] 同期先プロバイダーからの指定したナレッジに含まれていない項目の項目メタデータが含まれた変更バッチを返します。
戻り値
S_OK
E_POINTER
dwBatchSize が 0 の場合は E_INVALIDARG。
解説
このメソッドを使用すると、同期プロバイダーは IKnowledgeSyncProvider::GetChangeBatch メソッドを実装できるようになります。
プロバイダーは、このメソッドを呼び出す前に、メタデータ ストア内のバージョンにローカルの変更 (削除など) がすべて反映されていることを確認する必要があります。これを行うには、メタデータを明示的にメンテナンスすることによって、項目を列挙し、そのメタデータを更新します。
ISqlSyncMetadataStore から使用できるこのクラスの実装は、変更をグローバル ID の順に変更バッチに追加します。
ISqlSyncMetadataStore から使用できるこのクラスの実装は、送信する変更がこれ以上ない場合に返される変更バッチに対して SetLastBatch を呼び出します。
実装に関するメモ
グローバル ID の順序付けを使用し、範囲を使用できるプロバイダーをサポートするには、変更を列挙して変更バッチにグローバル ID 順に追加する必要があります。返された変更バッチ内の最初の変更によって新しい範囲が開始されます。
このバッチの後で送信する変更がこれ以上ない場合は、返される変更バッチに対して SetLastBatch を呼び出す必要があります。そうしないと、次の変更バッチを取得するために、Sync Framework によって IKnowledgeSyncProvider::GetChangeBatch が再度呼び出されます。