IReplicaMetadata::SaveReplicaMetadata
Saves replica metadata property changes to the metadata store.
Syntax
HRESULT SaveReplicaMetadata();
Parameters
None
Return Value
S_OK
S_FALSE if there are no changes to save.
Remarks
The provider must determine the correct level of precision at which to call this method, depending on its consistency guarantee. Some examples of when it might be appropriate to call this method include: after applying each change during change application, after each item batch is applied, or one time at the end of the synchronization session.
The implementation of this class that is available through ISqlSyncMetadataStore performs updates within the context of a transaction that was started before this method is called.
Note
This method does not save item metadata. To save changes to metadata for individual items, IReplicaMetadata::SaveItemMetadata must be called.
Notes for Implementers
This method must only succeed when all the property changes were successfully committed to the metadata store. Either all property changes must be committed or none of them.
If the metadata store supports transactions, this method must apply its changes to the metadata store within the context of that transaction.