Share via


IKnowledgeSyncProvider::GetSyncBatchParameters

Obtient le nombre demandé de modifications d'élément qui seront incluses dans les lots de modifications ainsi que la connaissance actuelle de l'étendue de synchronisation.

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

Paramètres

  • ppSyncKnowledge
    [out] Retourne la connaissance actuelle de l'étendue de synchronisation ou un objet de connaissance nouvellement créé s'il n'existe aucune connaissance actuelle.
  • pdwRequestedBatchSize
    [out] Retourne le nombre demandé de modifications d'élément qui seront incluses dans les lots de modifications retournés par le fournisseur de source.

Valeur de retour

  • S_OK

  • Codes d'erreur déterminés par le fournisseur

Notes

En règle générale, Sync Framework appelle cette méthode après avoir appelé IKnowledgeSyncProvider::BeginSession et avant d'appeler IKnowledgeSyncProvider::EndSession. Toutefois, la méthode IEndpointState::LoadFromProvider appelle cette méthode avant d'appeler BeginSession.

Remarques à l'attention des implémenteurs

Si aucune connaissance n'existe pour le réplica, utilisez IProviderSyncServices::CreateSyncKnowledge pour créer un objet de connaissance.

Avant que l'objet de connaissance ne soit retourné dans cette méthode,ISyncKnowledge::SetLocalTickCount doit être appelé sur l'objet de connaissance pour définir le nombre de cycles en fonction de celui en vigueur pour le réplica.

Le nombre de modifications d'élément envoyées dans pdwRequestedBatchSize est uniquement un nombre demandé. Le fournisseur de source peut ignorer cette valeur et retourner des lots de toute taille.

Voir aussi

Référence

Interface IKnowledgeSyncProvider