IReplicaMetadata::GetNextTickCount

增加先前为此副本保存的滴答计数,将新值保存到存储区,并返回该新值。

HRESULT GetNextTickCount(
  ULONGLONG * pNextTickCount);

参数

  • pNextTickCount
    [out] 此副本的更新滴答计数值。

返回值

  • S_OK

  • E_POINTER

备注

通过 ISqlSyncMetadataStore 获得的此类的实现立即将增加后的值保存到存储区中。如果存在未完成的显式事务,则该事务中将会进行上述操作,并且如果该事务没有被提交或回滚,则也将回滚该操作。

此方法主要在下列情况下对提供程序有帮助:

  • Sync Framework 调用 ISynchronousNotifyingChangeApplierTarget::GetCurrentTickCount。Sync Framework 请求变更应用方目标返回可用于为项分配新本地版本的新滴答计数值。

  • 提供程序正在对存储区进行元数据维护,且必须向通过非同步的机制所进行的变更分配新版本。此类变更的版本可通过组合本地副本键与调用 GetNextTickCount 而获得的下一个滴答计数来构造。

  • 提供程序正在跟踪其存储区的更新,并要为发生的每个更新设置一个新版本。新版本可通过组合本地副本键与调用 GetNextTickCount 而获得的下一个滴答计数来创建。

如果提供程序需要的是当前滴答计数而不是下一个滴答计数,则提供程序可先调用 IReplicaMetadata::GetKnowledge 来获取当前知识,然后从中提取当前滴答计数值。

请参阅

参考

IReplicaMetadata 接口