Partager via


IReplicaMetadata::GetNextTickCount

Incrémente le nombre de cycles enregistré précédemment pour ce réplica, enregistre la nouvelle valeur dans le magasin et retourne la nouvelle valeur.

HRESULT GetNextTickCount(
  ULONGLONG * pNextTickCount);

Paramètres

  • pNextTickCount
    [out] Valeur du nombre de cycles mise à jour pour ce réplica.

Valeur de retour

  • S_OK

  • E_POINTER

Notes

L'implémentation de cette classe qui est disponible via ISqlSyncMetadataStore enregistre immédiatement la valeur incrémentée dans le magasin. S'il y a une transaction explicite en attente, l'opération se produira au sein de cette transaction et sera restaurée si la transaction n'est pas validée ou est restaurée.

Cette méthode est principalement utile aux fournisseurs dans l'une des circonstances suivantes :

  • Sync Framework appelle ISynchronousNotifyingChangeApplierTarget::GetCurrentTickCount. Sync Framework attend que la cible d'applicateur de modifications retourne une nouvelle valeur du nombre de cycles qu'il peut utiliser pour assigner une nouvelle version locale pour un élément.

  • Le fournisseur assure la maintenance des métadonnées dans son magasin et doit assigner de nouvelles versions aux modifications apportées par le biais d'un mécanisme autre que la synchronisation. Une version pour une telle modification peut être construite en combinant la clé de réplica locale et le nombre de cycles suivant obtenu en appelant GetNextTickCount.

  • Le fournisseur suit les mises à jour dans son magasin et souhaite définir une nouvelle version pour chaque mise à jour qui se produit. La nouvelle version peut être créée en combinant la clé de réplica locale avec le nombre de cycles suivant obtenu en appelant GetNextTickCount.

Si un fournisseur souhaite avoir le nombre de cycles actuel au lieu du nombre de cycles suivant, il peut appeler IReplicaMetadata::GetKnowledge pour obtenir la connaissance actuelle, puis en extraire la valeur du nombre de cycles actuelle.

Voir aussi

Référence

Interface IReplicaMetadata