Interface IReplicaMetadata

Oferece acesso aos metadados da réplica e do item no repositório de metadados. IReplicaMetadata também fornece serviços para detecção de exclusões e auxiliares para a implementação de métodos do provedor de sincronização.

interface IReplicaMetadata : IUnknown

Membros

IReplicaMetadata pode ser subdividido nos seguintes grupos conceituais:

Metadados para uma réplica

Os seguintes membros de IReplicaMetadata fornecem acesso a metadados que são associados a uma réplica como um todo.

Métodos IReplicaMetadata	Descrição
IReplicaMetadata::GetReplicaId	Obtém a ID da réplica associada a esses metadados.
IReplicaMetadata::GetNextTickCount	Incrementa a contagem em escala previamente salva para esta réplica, salva o novo valor no repositório e retorna o novo valor.
IReplicaMetadata::GetKnowledge	Obtém o conhecimento atual desta réplica.
IReplicaMetadata::SetKnowledge	Define o conhecimento atual desta réplica.
IReplicaMetadata::GetForgottenKnowledge	Obtém o conhecimento esquecido desta réplica.
IReplicaMetadata::SetForgottenKnowledge	Define o conhecimento esquecido desta réplica.
IReplicaMetadata::GetCustomFieldMetadata	Obtém o campo de metadados personalizado associado a esta réplica.
IReplicaMetadata::SetCustomFieldMetadata	Define o campo de metadados personalizado associado a esta réplica.
IReplicaMetadata::SaveReplicaMetadata	Salva as alterações da propriedade dos metadados da réplica no repositório de metadados.

Dica

As alterações que são feitas em uma instância de IReplicaMetadata usando essas propriedades ou métodos serão salvas no repositório de metadados somente depois de SaveReplicaMetadata ser chamado.

Metadados para itens

Os seguintes membros de IReplicaMetadata fornecem acesso aos metadados dos itens.

Métodos IReplicaMetadata	Descrição
IReplicaMetadata::CreateEmptyFieldValue	Cria um novo objeto IFieldValue que contém valores padrão.
IReplicaMetadata::CreateNewItemMetadata	Cria um novo objeto IItemMetadata que pode ser usado para adicionar uma nova entrada de metadados do item ao repositório de metadados.
IReplicaMetadata::SaveItemMetadata	Salva as alterações da propriedade dos metadados do item no repositório de metadados.
IReplicaMetadata::RemoveItemMetadataByGlobalId	Remove os metadados do item do repositório de metadados.
IReplicaMetadata::FindItemMetadataByGlobalId	Obtém os metadados do item que tem a ID global especificada.
IReplicaMetadata::FindItemMetadataByUniqueIndexedFields	Retorna a entrada de metadados do item exclusiva que tem o valor especificado para o campo indexado.
IReplicaMetadata::FindItemMetadataByIndexedFields	Retorna uma lista de entradas de metadados do item que têm o valor especificado para o campo indexado.
IReplicaMetadata::GetLastDeletedItemsCleanupTime	Obtém a hora em que os itens excluídos foram limpos pela última vez por CleanupDeletedItems.
IReplicaMetadata::CleanupDeletedItems	Remove itens marcados como excluídos se passou o intervalo de tempo especificado desde a última limpeza.
IReplicaMetadata::GetItemCount	Obtém o número total de itens no repositório de metadados e o número de itens excluídos no repositório de metadados.

Dica

As alterações de propriedade que são feitas em uma instância de IItemMetadata só serão salvas no repositório de metadados depois que SaveItemMetadata for chamado.

Ajuda para provedores de sincronização

Os seguintes membros de IReplicaMetadata ajudam a implementar métodos do provedor de sincronização.

Métodos IReplicaMetadata	Descrição
IReplicaMetadata::GetItemBatchVersions	Obtém um lote de alterações que contém as versões dos itens que estão armazenados nesta réplica. Estes itens correspondem aos itens mencionados em um lote de alterações que é enviado de algum outro provedor.
IReplicaMetadata::GetFullEnumerationItemBatchVersions	Obtém um lote de alterações que contém as versões dos itens armazenados nesta réplica que corresponde aos itens mencionados em um lote de alterações enviadas de algum outro provedor, como parte de uma enumeração completa.
IReplicaMetadata::GetChangeBatch	Obtém um lote de alterações que contém metadados dos itens que não estão contidos no conhecimento especificado do provedor de destino.
IReplicaMetadata::GetFilteredChangeBatch	Obtém um lote de alterações que contém metadados dos itens que não estão contidos no conhecimento especificado do provedor de destino e que são aceitos pelo filtro estático ou dinâmico especificado.
IReplicaMetadata::GetFullEnumerationChangeBatch	Obtém um lote de alterações que contém metadados dos itens que têm IDs maiores do que o limite inferior especificado, como parte de uma enumeração completa.

Detecção de exclusão

O serviço de detecção de exclusão é um conjunto de métodos IReplicaMetadata que podem ser usados para determinar quais itens foram excluídos do repositório de itens e, portanto, devem ser marcados como excluídos no repositório de metadados.

Métodos IReplicaMetadata	Descrição
IReplicaMetadata::ResetReportingWatermark	Redefine o serviço de detecção de exclusão marcando todos os itens como não relatados.
IReplicaMetadata::ReportLiveItemByIndexedFields	Informa que o item identificado pelo valor de campo indexado está ativo e não deve ser considerado excluído.
IReplicaMetadata::ReportLiveItemByGlobalId	Informa que o item especificado está ativo e não deve ser considerado excluído.
IReplicaMetadata::GetUnreportedItems	Retorna uma lista de itens que não estão marcados como ativos no repositório de metadados e ainda não estão marcados como excluídos.
IReplicaMetadata::GetUnreportedItemsByIndexedFields	Uma lista de itens que têm o conjunto especificado de valores de campo indexado, não estão marcados como ativos no repositório de metadados e ainda não estão marcados como excluídos.

Requisitos

Cabeçalho: Metastore.h

Consulte também

Conceitos

Componentes do Sync Framework Metadata Storage Service
Acessando metadados de réplica
Interoperando com um provedor
Detectando itens excluídos