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, является только запрошенным числом. Поставщик источника может пропустить это значение и возвратить пакет любого размера.