共用方式為

IProviderMetadataUpgradeCallback 介面

  • 發行項

由衍生類別實作時，表示 Sync Framework 可呼叫的方法，以便向提供者通知因為提供者版本已變更而起始之中繼資料存放區升級期間發生的事件相關資訊。

interface IProviderMetadataUpgradeCallback : IUnknown

成員

IProviderMetadataUpgradeCallback 方法 描述

IProviderMetadataUpgradeCallback::OnProviderUpgradeRequired

指定給 ISyncMetadataStoreSerializer::DeserializeReplicaMetadata 的預期提供者相容性版本與序列化中繼資料中包含的提供者版本不符時發生。

IProviderMetadataUpgradeCallback::OnReplicaCustomFieldDeserialized

從序列化的中繼資料中讀取複寫的自訂中繼資料欄位時發生。

IProviderMetadataUpgradeCallback::OnItemMetadataDeserialized

針對從序列化中繼資料中讀取的每個項目發生一次。

備註

IProviderMetadataUpgradeCallback 介面通常會由提供者實作。

在提供者開啟中繼資料儲存服務存放區之後，它可以檢查與存放區內中繼資料相關聯的提供者版本，並且判斷是否必須升級中繼資料。若要取得與中繼資料相關聯的提供者版本，呼叫 IReplicaMetadata2::GetProviderVersion。

為了升級複寫的中繼資料，提供者會以標準格式儲存中繼資料、從目前的存放區中移除中繼資料、使用升級的結構描述來初始化中繼資料存放區內的新複寫中繼資料，然後使用 ISyncMetadataStoreSerializer::DeserializeReplicaMetadata 搭配 IProviderMetadataUpgradeCallback 物件，將中繼資料匯入存放區。如需詳細資訊，請參閱升級中繼資料存放區版本。

需求

**標頭：**MetaStore.h

請參閱

概念

Sync Framework Metadata Storage Service 元件