Freigeben über


IKnowledgeSyncProvider::GetSyncBatchParameters

Ruft die angeforderte Anzahl der in Änderungsbatches eingeschlossenen Elementänderungen sowie das aktuelle Wissen für den Synchronisierungsbereich ab.

HRESULT GetSyncBatchParameters(
  ISyncKnowledge ** ppSyncKnowledge,
  DWORD * pdwRequestedBatchSize);

Parameter

  • ppSyncKnowledge
    [out] Gibt das aktuelle Wissen für den Synchronisierungsbereich zurück oder gibt ein neu erstelltes Wissensobjekt zurück, wenn kein aktuelles Wissen vorhanden ist.
  • pdwRequestedBatchSize
    [out] Gibt die angeforderte Anzahl der Elementänderungen zurück, die in die von diesem Quellenanbieter zurückgegebenen Änderungsbatches eingeschlossen werden.

Rückgabewert

  • S_OK

  • Vom Anbieter bestimmte Fehlercodes.

Hinweise

In der Regel ruft Sync Framework diese Methode auf, nachdem IKnowledgeSyncProvider::BeginSession aufgerufen wurde und bevor IKnowledgeSyncProvider::EndSession aufgerufen wird. Die IEndpointState::LoadFromProvider-Methode ruft jedoch diese Methode auf, bevor BeginSession aufgerufen wird.

Hinweise für Implementierer

Wenn kein Wissen für das Replikat vorhanden ist, verwenden Sie IProviderSyncServices::CreateSyncKnowledge, um ein neues Wissensobjekt zu erstellen.

Bevor das Wissensobjekt in dieser Methode zurückgegeben wird, muss ISyncKnowledge::SetLocalTickCount für das Wissensobjekt aufgerufen werden, um die Taktanzahl auf die aktuelle Taktanzahl für das Replikat festzulegen.

Die Anzahl der Elementänderungen, die in pdwRequestedBatchSize gesendet werden, ist nur eine angeforderte Anzahl. Der Quellenanbieter kann diesen Wert ignorieren und Batches beliebiger Größe zurückgeben.

Siehe auch

Verweis

IKnowledgeSyncProvider-Schnittstelle