IKnowledgeSyncProvider::GetSyncBatchParameters
変更バッチに含める項目変更の要求された数と、同期スコープの現在のナレッジを取得します。
HRESULT GetSyncBatchParameters(
ISyncKnowledge ** ppSyncKnowledge,
DWORD * pdwRequestedBatchSize);
パラメータ
- ppSyncKnowledge
[out] 同期スコープの現在のナレッジか、現在のナレッジが存在しない場合は新しく作成されたナレッジ オブジェクトを返します。
- pdwRequestedBatchSize
[out] 同期元プロバイダによって返された変更バッチに含める項目変更の要求された数を返します。
戻り値
S_OK
プロバイダが決定したエラー コード
解説
通常、Sync Framework は、IKnowledgeSyncProvider::BeginSession を呼び出してから IKnowledgeSyncProvider::EndSession を呼び出すまでの間にこのメソッドを呼び出します。ただし、IEndpointState::LoadFromProvider メソッドは、BeginSession を呼び出す前にこのメソッドを呼び出します。
実装に関するメモ
レプリカにナレッジが存在しない場合は、IProviderSyncServices::CreateSyncKnowledge を使用して新しいナレッジ オブジェクトを作成します。
ナレッジ オブジェクトがこのメソッドで返される前に、ナレッジ オブジェクトで ISyncKnowledge::SetLocalTickCount を呼び出して、ティック数をレプリカの現在のティック数に設定する必要があります。
pdwRequestedBatchSize で送信される項目変更の数は、要求された数のみです。同期元プロバイダは、この値を無視して、任意のサイズのバッチを返すことができます。