IReplicaMetadata::SaveReplicaMetadata

Saves replica metadata property changes to the metadata store.

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.

See Also

Reference

IReplicaMetadata Interface