IReplicaMetadata::SaveReplicaMetadata

将副本元数据属性变更保存到元数据存储区中。

HRESULT SaveReplicaMetadata();

参数

返回值

  • S_OK

  • 如果没有要保存的变更,则返回值为 S_FALSE。

备注

提供程序必须在保证其一致性的前提下确定调用此方法的正确精度级别。例如,适合提供程序调用此方法的情况包括:在变更应用期间应用了所有变更后、应用了所有项批后,或在同步会话结束时调用一次。

通过 ISqlSyncMetadataStore 获得的此类的实现在调用此方法前启动的事务的上下文中执行更新。

备注

此方法不保存项元数据。若要保存单个项的元数据变更,必须调用 IReplicaMetadata::SaveItemMetadata

实施者注意事项

此方法仅在所有属性变更均已成功提交到元数据存储区后才会成功。或者所有属性变更均已提交,或者任何属性变更均未提交。

如果元数据存储区支持事务,则此方法必须在该事务的上下文中将其变更应用于元数据存储区中。

请参阅

参考

IReplicaMetadata 接口