Interfaccia IReplicaMetadata

Fornisce l'accesso ai metadati della replica e degli elementi nell'archivio dei metadati. IReplicaMetadata fornisce inoltre servizi per il rilevamento delle eliminazioni e funzioni di supporti per l'implementazione dei metodi del provider di sincronizzazione.

interface IReplicaMetadata : IUnknown

Membri

IReplicaMetadata può essere suddiviso nei gruppi concettuali seguenti.

Metadati per una replica

I membri seguenti di IReplicaMetadata forniscono l'accesso ai metadati associati a una replica nel suo complesso.

Metodi IReplicaMetadata	Descrizione
IReplicaMetadata::GetReplicaId	Ottiene l'ID della replica associata ai metadati.
IReplicaMetadata::GetNextTickCount	Incrementa il conteggio salvato in precedenza per la replica, salva il nuovo valore nell'archivio e restituisce il nuovo valore.
IReplicaMetadata::GetKnowledge	Ottiene la conoscenza corrente per la replica.
IReplicaMetadata::SetKnowledge	Imposta la conoscenza corrente per la replica.
IReplicaMetadata::GetForgottenKnowledge	Ottiene la conoscenza dimenticata per la replica.
IReplicaMetadata::SetForgottenKnowledge	Imposta la conoscenza dimenticata per la replica.
IReplicaMetadata::GetCustomFieldMetadata	Ottiene il campo di metadati personalizzato associato alla replica.
IReplicaMetadata::SetCustomFieldMetadata	Imposta il campo di metadati personalizzato associato alla replica.
IReplicaMetadata::SaveReplicaMetadata	Salva le modifiche apportate alle proprietà dei metadati della replica nell'archivio dei metadati.

Nota

Le modifiche apportate in un'istanza di IReplicaMetadata utilizzando questi metodi o proprietà verranno salvate nell'archivio dei metadati solo dopo la chiamata a SaveReplicaMetadata.

Metadati per gli elementi

I membri seguenti di IReplicaMetadata forniscono l'accesso ai metadati per gli elementi.

Metodi IReplicaMetadata	Descrizione
IReplicaMetadata::CreateEmptyFieldValue	Crea un nuovo oggetto IFieldValue che contiene valori predefiniti.
IReplicaMetadata::CreateNewItemMetadata	Crea un nuovo oggetto IItemMetadata che può essere utilizzato per aggiungere una nuova voce di metadati dell'elemento all'archivio dei metadati.
IReplicaMetadata::SaveItemMetadata	Salva le modifiche apportate alle proprietà dei metadati dell'elemento nell'archivio dei metadati.
IReplicaMetadata::RemoveItemMetadataByGlobalId	Rimuove i metadati dell'elemento dall'archivio dei metadati.
IReplicaMetadata::FindItemMetadataByGlobalId	Ottiene i metadati dell'elemento associato all'ID globale specificato.
IReplicaMetadata::FindItemMetadataByUniqueIndexedFields	Restituisce la voce di metadati dell'elemento univoca con il valore specificato per il campo indicizzato.
IReplicaMetadata::FindItemMetadataByIndexedFields	Restituisce un elenco di voci di metadati dell'elemento con il valore specificato per il campo indicizzato.
IReplicaMetadata::GetLastDeletedItemsCleanupTime	Ottiene l'ora in cui è stata eseguita l'ultima pulizia degli elementi eliminati tramite CleanupDeletedItems.
IReplicaMetadata::CleanupDeletedItems	Rimuove gli elementi contrassegnati come eliminati se è trascorso l'intervallo di tempo specificato dopo l'ultima pulizia.
IReplicaMetadata::GetItemCount	Ottiene il numero totale di elementi e quello degli elementi eliminati nell'archivio dei metadati.

Nota

Le modifiche apportate alle proprietà eseguite in un'istanza di IItemMetadata verranno salvate nell'archivio dei metadati solo dopo la chiamata a SaveItemMetadata.

Supporto per i provider di sincronizzazione

I membri seguenti di IReplicaMetadata consentono di implementare i metodi del provider di sincronizzazione.

Metodi IReplicaMetadata	Descrizione
IReplicaMetadata::GetItemBatchVersions	Ottiene un batch di modifiche contenente le versioni degli elementi archiviati in questa replica. Questi elementi corrispondono agli elementi a cui viene fatto riferimento in un batch di modifiche inviato da un altro provider.
IReplicaMetadata::GetFullEnumerationItemBatchVersions	Ottiene un batch di modifiche contenente le versioni degli elementi archiviati nella replica corrispondenti agli elementi a cui viene fatto riferimento in un batch di modifiche inviato da un altro provider, come parte di un'enumerazione completa.
IReplicaMetadata::GetChangeBatch	Ottiene un batch di modifiche contenente i metadati per gli elementi non contenuti nella conoscenza specificata del provider di destinazione.
IReplicaMetadata::GetFilteredChangeBatch	Ottiene un batch di modifiche contenente i metadati per gli elementi non contenuti nella conoscenza specificata del provider di destinazione e accettati dal filtro statico o dinamico specificato.
IReplicaMetadata::GetFullEnumerationChangeBatch	Ottiene un batch di modifiche contenente metadati per elementi con ID superiori al limite inferiore specificato, come parte di un'enumerazione completa.

Rilevamento delle eliminazioni

Il servizio di rilevamento delle eliminazioni è un set di metodi IReplicaMetadata che è possibile utilizzare per determinare gli elementi eliminati dall'archivio che devono pertanto essere contrassegnati come eliminati nell'archivio dei metadati.

Metodi IReplicaMetadata	Descrizione
IReplicaMetadata::ResetReportingWatermark	Reimposta il servizio di rilevamento delle eliminazioni contrassegnando tutti gli elementi come non segnalati.
IReplicaMetadata::ReportLiveItemByIndexedFields	Segnala che l'elemento identificato dal valore del campo indicizzato è attivo e non deve essere considerato come eliminato.
IReplicaMetadata::ReportLiveItemByGlobalId	Segnala che l'elemento specificato è attivo e non deve essere considerato come eliminato.
IReplicaMetadata::GetUnreportedItems	Restituisce un elenco di elementi che, oltre a non essere contrassegnati come attivi nell'archivio dei metadati, non sono ancora contrassegnati come eliminati.
IReplicaMetadata::GetUnreportedItemsByIndexedFields	Restituisce un elenco di elementi con il set specificato di valori di campo indicizzati che oltre a non essere contrassegnati come attivi nell'archivio dei metadati, non sono ancora contrassegnati come eliminati.

Requisiti

Intestazione: Metastore.h

Vedere anche

Concetti

Componenti del servizio di archiviazione dei metadati di Sync Framework
Accesso ai metadati della replica
Interoperabilità con un provider
Rilevamento di elementi eliminati