Freigeben über


IProviderMetadataUpgradeCallback-Schnittstelle

Wenn diese von einer abgeleiteten Klasse implementiert wird, stellt sie Methoden dar, die Sync Framework aufrufen kann, um einen Anbieter über Ereignisse zu benachrichtigen, die bei der Aktualisierung eines Metadatenspeichers auftreten, die aufgrund einer Änderung der Anbieterversion initiiert wurde.

interface IProviderMetadataUpgradeCallback : IUnknown

Member

IProviderMetadataUpgradeCallback-Methode Beschreibung

IProviderMetadataUpgradeCallback::OnProviderUpgradeRequired

Tritt auf, wenn die erwartete Anbieterkompatibilitätsversion, für die ISyncMetadataStoreSerializer::DeserializeReplicaMetadata angegeben wurde, nicht mit der Anbieterversion übereinstimmt, die in den serialisierten Daten enthalten ist.

IProviderMetadataUpgradeCallback::OnReplicaCustomFieldDeserialized

Tritt auf, wenn das benutzerdefinierte Metadatenfeld für das Replikat aus den serialisierten Metadaten gelesen wird.

IProviderMetadataUpgradeCallback::OnItemMetadataDeserialized

Tritt einmalig für jedes Element auf, das aus den serialisierten Metadaten gelesen wird.

Hinweise

Die IProviderMetadataUpgradeCallback-Schnittstelle wird in der Regel von einem Anbieter implementiert.

Wenn ein Anbieter einen Metadaten-Speicherdienstspeicher öffnet, kann dieser die Anbieterversion überprüfen, die den Metadaten im Speicher zugeordnet ist, und festlegen, ob die Metadaten aktualisiert werden müssen. Rufen Sie zum Abrufen der den Metadaten zugeordneten Anbieterversion IReplicaMetadata2::GetProviderVersion auf.

Um die Metadaten für ein Replikat zu aktualisieren, speichert der Anbieter die Metadaten in einem kanonischen Format, entfernt die Metadaten aus dem aktuellen Speicher, initialisiert neue Replikatmetadaten mit dem aktualisierten Schema im Metadatenspeicher und importiert die Metadaten mithilfe von ISyncMetadataStoreSerializer::DeserializeReplicaMetadata zusammen mit einem IProviderMetadataUpgradeCallback-Objekt in den Speicher. Weitere Informationen finden Sie unter Aktualisieren der Metadatenspeicherversion.

Anforderungen

Header: MetaStore.h

Siehe auch

Konzepte

Komponenten des Metadatenspeicherdiensts von Sync Framework