Partager via

Interface ISqlSyncMetadataStore

  • Article

Représente un magasin des métadonnées qui utilise une base de données légère pour le stockage.

interface ISqlSyncMetadataStore : ISyncMetadataStore2

Membres

Méthodes ISqlSyncMetadataStore Description

ISqlSyncMetadataStore::CreateStore

Crée un fichier de magasin des métadonnées et un objet de magasin des métadonnées pour le représenter.

ISqlSyncMetadataStore::OpenStore

Ouvre un fichier de magasin des métadonnées existant et retourne un objet de magasin des métadonnées qui le représente.

ISqlSyncMetadataStore::Dispose

Libère les ressources qui sont utilisées par l'objet ISqlSyncMetadataStore.

Notes

Le service de stockage des métadonnées offre une implémentation complète de l'API du service de stockage des métadonnées qui utilise une base de données légère pour stocker toutes les métadonnées requises pour la synchronisation dans un fichier de base de données à un emplacement spécifié du système de fichiers. Le point d'entrée dans cette implémentation est ISqlSyncMetadataStore. Pour obtenir un objet qui implémente cette interface, passez CLSID_SyncMetadataStore et IID_ISqlSyncMetadataStore à la fonction CoCreateInstance.

Pour utiliser l'implémentation de l'API du service de stockage des métadonnées

  1. Créez un nouveau magasin des métadonnées en utilisant ISqlSyncMetadataStore::CreateStore ou ouvrez un magasin des métadonnées existant à l'aide de ISqlSyncMetadataStore::OpenStore.

  2. Créez les métadonnées pour un réplica spécifié à l'aide d'ISyncMetadataStore::InitializeReplicaMetadata ou ouvrez les métadonnées du réplica existant en utilisant ISyncMetadataStore::GetReplicaMetadata. GetReplicaMetadata retournent une implémentation de IReplicaMetadata qui peut accéder aux métadonnées de réplica stockées dans le magasin des métadonnées.

  3. Commencez une transaction de base de données en utilisant ISyncMetadataStore::BeginTransaction. Cela permet de garantir que, pour les modifications apportées aux métadonnées après avoir appelé cette méthode, toutes les modifications sont enregistrées dans la base de données ou aucune ne l'est.

  4. Créez de nouvelles métadonnées d'élément en utilisant IReplicaMetadata::CreateNewItemMetadata ou recherchez des métadonnées pour des éléments individuels en utilisant des méthodes telles que IReplicaMetadata::FindItemMetadataByGlobalId. Ces méthodes retournent une implémentation de IItemMetadata qui peut accéder aux métadonnées d'élément stockées dans le magasin des métadonnées.

  5. Apportez des modifications aux métadonnées d'élément et enregistrez ces modifications en utilisant IReplicaMetadata::SaveItemMetadata.

  6. Validez les modifications apportées au magasin des métadonnées en appelant ISyncMetadataStore::CommitTransaction, ou ignorez les modifications en appelant ISyncMetadataStore::RollbackTransaction.

Cette implémentation de l'API fournit également des méthodes sur l'objet IReplicaMetadata qui permettent de détecter des éléments supprimés du magasin d'éléments. Par exemple, IReplicaMetadata::GetUnreportedItems retourne une liste des éléments qui existent dans le magasin des métadonnées, mais n'existent pas dans le magasin d'éléments. Un fournisseur peut alors marquer les éléments de cette liste comme objets tombstone dans le magasin des métadonnées.

Spécifications

En-tête : Metastore.h

Voir aussi

Concepts

Composants de Metadata Storage Service de Sync Framework
Mise en route du stockage des métadonnées