IProviderMetadataUpgradeCallback インターフェイス
派生クラスによって実装された場合、プロバイダーのバージョンが変更されたために実行されたメタデータ ストアのアップグレード中に発生したイベントをプロバイダーに通知するために Sync Framework が呼び出すことができるメソッドを表します。
構文
interface IProviderMetadataUpgradeCallback : IUnknown
メンバー
IProviderMetadataUpgradeCallback メソッド |
説明 |
|---|---|
ISyncMetadataStoreSerializer::DeserializeReplicaMetadata に指定された予想されるプロバイダー互換性バージョンが、シリアル化されたメタデータに含まれるプロバイダー バージョンと一致しないときに発生します。 |
|
IProviderMetadataUpgradeCallback::OnReplicaCustomFieldDeserialized |
レプリカのカスタム メタデータ フィールドがシリアル化されたメタデータから読み取られるときに発生します。 |
IProviderMetadataUpgradeCallback::OnItemMetadataDeserialized |
シリアル化されたメタデータから読み取られる項目ごとに、1 回発生します。 |
説明
IProviderMetadataUpgradeCallback インターフェイスは、通常、プロバイダーによって実装されます。
プロバイダーが Metadata Storage Service ストアを開いた後、ストア内のメタデータに関連付けられているプロバイダー バージョンをチェックし、メタデータをアップグレードする必要があるかどうかを判定できます。メタデータに関連付けられているプロバイダー バージョンを取得するには、IReplicaMetadata2::GetProviderVersion を呼び出します。
レプリカのメタデータをアップグレードする場合、プロバイダーは、メタデータを正規の形式で保存し、現在のストアからメタデータを削除します。さらに、アップグレードされたスキーマを使用してメタデータ ストア内の新しいレプリカ メタデータを初期化し、ISyncMetadataStoreSerializer::DeserializeReplicaMetadata と共に IProviderMetadataUpgradeCallback オブジェクトを使用して、このメタデータをストアにインポートします。詳細については、「メタデータ ストアのアップグレード」を参照してください。
要件
ヘッダー: MetaStore.h