IProviderMetadataUpgradeCallback 接口

通过派生类实现时,表示 Sync Framework 可以调用的方法,这些方法可用于通知提供程序有关在因提供程序版本发生变更而启动的元数据存储区升级的过程中发生的事件。

interface IProviderMetadataUpgradeCallback : IUnknown

成员

IProviderMetadataUpgradeCallback 方法 说明

IProviderMetadataUpgradeCallback::OnProviderUpgradeRequired

在为 ISyncMetadataStoreSerializer::DeserializeReplicaMetadata 指定的所需提供程序兼容性版本与序列化元数据中包含的提供程序版本不一致时发生。

IProviderMetadataUpgradeCallback::OnReplicaCustomFieldDeserialized

从序列化的元数据读取副本的自定义元数据字段时发生。

IProviderMetadataUpgradeCallback::OnItemMetadataDeserialized

对从序列化的元数据中读取的每个项发生一次。

备注

IProviderMetadataUpgradeCallback 接口通常由提供程序实现。

在提供程序打开元数据存储服务存储区后,它会检查与存储区中的元数据关联的提供程序版本,并确定是否必须升级元数据。若要获取与元数据关联的提供程序版本,请调用 IReplicaMetadata2::GetProviderVersion

为了升级副本的元数据,提供程序将执行以下操作:以规范格式保存元数据,从当前存储区中删除元数据,通过使用升级的架构来初始化元数据存储区中的新副本元数据,并将 ISyncMetadataStoreSerializer::DeserializeReplicaMetadataIProviderMetadataUpgradeCallback 对象一起使用以将元数据导入存储区中。有关详细信息,请参阅升级元数据存储区版本

要求

**头文件:**Metastore.h

请参阅

概念

Sync Framework Metadata Storage Service 组件