IProviderUpgradeCallback Interface

SQL Server 2008 R2

When implemented by a derived class, represents methods that Sync Framework can call to notify a provider about events that occur during a metadata store upgrade that is initiated because the provider version has changed.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

public interface IProviderUpgradeCallback
public interface IProviderUpgradeCallback
public interface IProviderUpgradeCallback

The IProviderUpgradeCallback interface is typically implemented by a provider.

After a provider opens a metadata storage service store, it can check the provider version that is associated with the metadata in the store, and determine whether the metadata must be upgraded. The provider version associated with the metadata is stored in the ProviderVersion property.

To upgrade the metadata for a replica, the provider saves the metadata in canonical format, removes the metadata from the current store, initializes new replica metadata in the metadata store by using the upgraded schema, and imports the metadata into the store by using DeserializeReplicaMetadata together with an IProviderUpgradeCallback object. For more information, see Upgrading the Metadata Store Version.