IReplicaMetadata::GetNextTickCount
Incrementa a contagem em escala previamente salva para esta réplica, salva o novo valor no repositório e retorna o novo valor.
HRESULT GetNextTickCount(
ULONGLONG * pNextTickCount);
Parâmetros
- pNextTickCount
[out] O valor da contagem em escala de atualização desta réplica.
Valor de retorno
S_OK
E_POINTER
Comentários
A implementação desta classe disponível através de ISqlSyncMetadataStore salva imediatamente o valor incrementado no repositório. Se houver uma transação explícita pendente, a operação ocorrerá nessa transação e será revertida se a transação não for confirmada ou revertida.
Este método é especialmente útil para os provedores em uma das seguintes circunstâncias:
Sync Framework chama ISynchronousNotifyingChangeApplierTarget::GetCurrentTickCount. Sync Framework espera que o destino do aplicador de alterações retorne um novo valor da contagem em escala que possa ser usado para atribuir uma nova versão local a um item.
O provedor está fazendo manutenção dos metadados em seu repositório e tem que atribuir novas versões para alterações que foram feitas por algum outro mecanismo, que não a sincronização. Uma versão para tal alteração pode ser criada com a combinação da chave de réplica local e da próxima contagem em escala que é obtida chamando GetNextTickCount.
O provedor está controlando atualizações em seu repositório e quer definir uma nova versão para cada atualização que houver. A versão pode ser criada com a combinação da chave de réplica local e da próxima contagem em escala que é obtida chamando GetNextTickCount.
Se um provedor quiser a contagem em escala atual em vez da próxima contagem em escala, o provedor poderá chamar IReplicaMetadata::GetKnowledge para obter o conhecimento atual e, em seguida, extrair o valor da contagem em escala atual.