ISyncMetadataStore::GetReplicaMetadata
Obtém o objeto IReplicaMetadata que representa os metadados de uma réplica específica.
HRESULT GetReplicaMetadata(
BYTE * pbReplicaId,
ID_PARAMETERS * pIdParameters,
IReplicaMetadata ** ppReplicaMetadata);
Parâmetros
Parâmetro |
Descrição |
pbReplicaId |
[in] A ID da réplica para a qual os metadados da réplica serão recuperados. |
pIdParameters |
[in] O esquema de formato de ID do provedor. |
ppReplicaMetadata |
[out] Retorna os metadados da réplica. |
Valor de retorno
S_OK.
E_POINTER.
E_OUTOFMEMORY.
E_UNEXPECTED se o repositório de metadados ainda não estiver aberto.
SYNC_E_METADATA_REPLICA_NOT_FOUND quando não existem metadados para a ID da réplica especificada.
SYNC_E_IDFORMATMISMATCH quando o esquema de formato de ID não corresponde ao esquema de formato de ID especificado quando os metadados da réplica foram inicializados.
SYNC_E_METADATA_REPLICA_IN_USE quando uma instância deste objeto de metadados da réplica já está ativa.
Comentários
Para impedir que aplicativos façam atualizações simultâneas conflitantes no repositório de metadados, não são permitidas várias instâncias pendentes do IReplicaMetadata para uma ID da réplica específica. Os aplicativos podem acessar o mesmo objeto IReplicaMetadata de vários threads, porém vários processos não podem acessar os mesmos metadados da réplica simultaneamente. Se já houver uma instância pendente de IReplicaMetadata para uma ID da réplica específica, este método retornará SYNC_E_METADATA_REPLICA_IN_USE.