Interfaccia ISqlSyncMetadataStore

Rappresenta un archivio dei metadati che utilizza un database lightweight per l'archiviazione.

interface ISqlSyncMetadataStore : ISyncMetadataStore2

Membri

Metodi ISqlSyncMetadataStore	Descrizione
ISqlSyncMetadataStore::CreateStore	Crea un file dell'archivio dei metadati e un oggetto archivio dei metadati per rappresentarlo.
ISqlSyncMetadataStore::OpenStore	Apre un file dell'archivio dei metadati esistente e restituisce un oggetto archivio dei metadati che lo rappresenta.
ISqlSyncMetadataStore::Dispose	Rilascia le risorse utilizzate dall'oggetto ISqlSyncMetadataStore.

Osservazioni

Nel servizio di archiviazione dei metadati è disponibile un'implementazione completa dell'API del servizio di archiviazione dei metadati che utilizza un database lightweight per archiviare tutti i metadati necessari per la sincronizzazione in un unico file di database in un percorso specificato nel file system. Il punto di ingresso a questa implementazione è ISqlSyncMetadataStore. Per ottenere un oggetto che implementi questa interfaccia, passare CLSID_SyncMetadataStore e IID_ISqlSyncMetadataStore alla funzione CoCreateInstance.

Per utilizzare l'implementazione dell'API del servizio di archiviazione dei metadati

Creare un nuovo archivio dei metadati utilizzando ISqlSyncMetadataStore::CreateStore oppure aprirne uno esistente utilizzando ISqlSyncMetadataStore::OpenStore. Creare i metadati per la replica specificata utilizzando ISyncMetadataStore::InitializeReplicaMetadata oppure aprire i metadati della replica esistenti utilizzando ISyncMetadataStore::GetReplicaMetadata.GetReplicaMetadata restituiscono un'implementazione di IReplicaMetadata che può accedere ai metadati della replica archiviati nell'archivio dei metadati. Avviare una transazione di database utilizzando ISyncMetadataStore::BeginTransaction. In questo modo si garantisce che nel database vengano salvate tutte le modifiche apportate ai metadati dopo la chiamata a questo metodo o che non venga salvata alcuna modifica. Creare nuovi metadati dell'elemento utilizzando IReplicaMetadata::CreateNewItemMetadata oppure individuare i metadati per i singoli elementi utilizzando metodi quali IReplicaMetadata::FindItemMetadataByGlobalId. Questi metodi restituiscono un'implementazione di IItemMetadata che può accedere ai metadati dell'elemento archiviati nell'archivio dei metadati. Apportare le modifiche ai metadati dell'elemento e salvarle utilizzando IReplicaMetadata::SaveItemMetadata. Eseguire il commit delle modifiche nell'archivio dei metadati chiamando ISyncMetadataStore::CommitTransaction oppure ignorare le modifiche chiamando ISyncMetadataStore::RollbackTransaction.

Questa implementazione dell'API fornisce inoltre metodi nell'oggetto IReplicaMetadata che consentono di rilevare gli elementi eliminati dall'archivio di elementi. Ad esempio, IReplicaMetadata::GetUnreportedItems restituisce un elenco di elementi esistenti nell'archivio dei metadati ma non in quello degli elementi. Un provider può quindi contrassegnare gli elementi dell'elenco per la rimozione definitiva nell'archivio dei metadati.

Requisiti

Intestazione: Metastore.h

Vedere anche

Concetti

Componenti del servizio di archiviazione dei metadati di Sync Framework
Guida introduttiva all'archiviazione dei metadati