Интерфейс IProviderMetadataUpgradeCallback
При реализации в производном классе представляет методы, которые Sync Framework может вызвать для уведомления поставщика о событиях, происходящих во время обновления хранилища метаданных вследствие изменения версии поставщика.
interface IProviderMetadataUpgradeCallback : IUnknown
Элементы
Метод IProviderMetadataUpgradeCallback | Описание |
---|---|
Возникает, когда ожидаемая версия совместимости, указанная при вызове метода ISyncMetadataStoreSerializer::DeserializeReplicaMetadata, не соответствует версии поставщика, содержащейся в сериализованных метаданных. |
|
IProviderMetadataUpgradeCallback::OnReplicaCustomFieldDeserialized |
Возникает, когда пользовательское поле метаданных для реплики считывается из сериализованных метаданных. |
IProviderMetadataUpgradeCallback::OnItemMetadataDeserialized |
Возникает по одному разу для каждого элемента, считываемого из сериализованных метаданных. |
Замечания
Как правило, интерфейс IProviderMetadataUpgradeCallback реализуется поставщиком.
После того как поставщик открыл хранилище службы хранилища метаданных, он может проверить версию поставщика, связанную с метаданными в хранилище, и определить необходимость их обновления. Чтобы получить версию поставщика, связанную с метаданными, вызовите метод IReplicaMetadata2::GetProviderVersion.
Чтобы обновить метаданные для реплики, поставщик сохраняет метаданные в каноническом формате, удаляет их из текущего хранилища, инициализирует новые метаданные реплики в хранилище метаданных с использованием новой версии схемы, а затем импортирует метаданные в хранилище с помощью метода ISyncMetadataStoreSerializer::DeserializeReplicaMetadata, передав ему объект IProviderMetadataUpgradeCallback. Дополнительные сведения см. в разделе Обновление версии хранилища метаданных.
Системные требования
Заголовок: MetaStore.h