IReplicaMetadata::GetNextTickCount
Erhöht die zuvor gespeicherte Taktanzahl dieses Replikats, speichert den neuen Wert und gibt ihn zurück.
HRESULT GetNextTickCount(
ULONGLONG * pNextTickCount);
Parameter
- pNextTickCount
[out] Der aktualisierte Taktanzahlwert für dieses Replikat.
Rückgabewert
S_OK
E_POINTER
Hinweise
Die Implementierung dieser Klasse, die durch ISqlSyncMetadataStore verfügbar ist, schreibt den erhöhten Wert sofort in den Speicher. Bei einer ausstehenden expliziten Transaktion wird der Vorgang innerhalb dieser Transaktion ausgeführt. Es wird für den Vorgang ein Rollback ausgeführt, wenn für die Transaktion kein Commit oder ein Rollback ausgeführt wird.
Diese Methode ist für Anbieter vor allem unter folgenden Umständen hilfreich:
Sync Framework ruft ISynchronousNotifyingChangeApplierTarget::GetCurrentTickCount auf. Sync Framework erwartet, dass das Ziel der Änderungsanwendung einen neuen Wert für die Taktanzahl zurückgibt, mit der eine neue lokale Version für ein Element zugewiesen werden kann.
Der Anbieter verwaltet die Metadaten in seinem Speicher und muss Änderungen, die nicht durch Synchronisierung vorgenommen wurden, neue Versionen zuweisen. Für diese Änderungen können Versionen erstellt werden, in dem der lokale Replikatschlüssel mit der nächsten Taktanzahl kombiniert wird, die durch Aufrufen von GetNextTickCount erhalten wird.
Der Anbieter verfolgt Änderungen in seinem Speicher und legt für jede Aktualisierung eine neue Version fest. Die neue Version kann erstellt werden, in dem der lokale Replikatschlüssel mit der nächsten Taktanzahl kombiniert wird, die durch Aufrufen von GetNextTickCount erhalten wird.
Wenn ein Anbieter statt der nächsten die aktuelle Taktanzahl benötigt, kann er IReplicaMetadata::GetKnowledge aufrufen, um das aktuelle Wissen abzurufen und den Wert der aktuellen Taktanzahl daraus zu extrahieren.