Compartir a través de

Interfaz ISqlSyncMetadataStore

  • Artículo

Representa un almacén de metadatos que usa una base de datos ligera para el almacenamiento.

interface ISqlSyncMetadataStore : ISyncMetadataStore2

Miembros

Métodos de ISqlSyncMetadataStore Descripción

ISqlSyncMetadataStore::CreateStore

Crea un archivo de almacén de metadatos y un objeto de almacén de metadatos para representarlo.

ISqlSyncMetadataStore::OpenStore

Abre un archivo de almacén de metadatos existente y devuelve un objeto de almacén de metadatos que lo representa.

ISqlSyncMetadataStore::Dispose

Libera los recursos usados por el objeto ISqlSyncMetadataStore.

Notas

Metadata Storage Service proporciona una implementación completa de la API de Metadata Storage Service que usa una base de datos ligera para almacenar todos los metadatos necesarios para la sincronización en un archivo de base de datos situado en una ubicación especificada del sistema de archivos. El punto de entrada en esta implementación es ISqlSyncMetadataStore. Para obtener un objeto que implemente esta interfaz, pase CLSID_SyncMetadataStore e IID_ISqlSyncMetadataStore a la función CoCreateInstance.

Para usar la implementación de la API de Metadata Storage Service

  1. Cree un nuevo almacén de metadatos mediante ISqlSyncMetadataStore::CreateStore o abra un almacén de metadatos existente mediante ISqlSyncMetadataStore::OpenStore.

  2. Cree metadatos para una réplica especificada mediante ISyncMetadataStore::InitializeReplicaMetadata, o abra los metadatos de una réplica existente usando ISyncMetadataStore::GetReplicaMetadata. GetReplicaMetadata devuelve una implementación de IReplicaMetadata que puede tener acceso a los metadatos de la réplica que se almacenan en el almacén de metadatos.

  3. Inicie una transacción de base de datos mediante ISyncMetadataStore::BeginTransaction. Esto ayuda a garantizar que los cambios realizados en los metadatos tras llamar a este método se guardan todos en la base de datos o no se guarda ninguno.

  4. Cree metadatos de elemento nuevos mediante IReplicaMetadata::CreateNewItemMetadata o busque metadatos de elementos individuales mediante métodos como IReplicaMetadata::FindItemMetadataByGlobalId. Estos métodos devuelven una implementación de IItemMetadata que puede tener acceso a los metadatos de elementos almacenados en el almacén de metadatos.

  5. Realice cambios en los metadatos del elemento y guarde los cambios mediante IReplicaMetadata::SaveItemMetadata.

  6. Confirme los cambios en el almacén de metadatos llamando a ISyncMetadataStore::CommitTransaction, o descártelos llamando a ISyncMetadataStore::RollbackTransaction.

Esta implementación de la API también proporciona métodos en el objeto IReplicaMetadata que permiten detectar los elementos eliminados del almacén de elementos. Por ejemplo, IReplicaMetadata::GetUnreportedItems devuelve una lista de elementos que existen en el almacén de metadatos, pero no en el almacén de elementos. De esta forma, un proveedor puede marcar los elementos de esta lista como marcadores de exclusión en el almacén de metadatos.

Requisitos

Encabezado: Metastore.h

Vea también

Conceptos

Componentes de Sync Framework Metadata Storage Service
Introducción al almacenamiento de metadatos