ISyncMetadataStore::GetReplicaMetadata
Obtient l'objet IReplicaMetadata qui représente les métadonnées d'un réplica donné.
HRESULT GetReplicaMetadata(
BYTE * pbReplicaId,
ID_PARAMETERS * pIdParameters,
IReplicaMetadata ** ppReplicaMetadata);
Paramètres
Paramètre |
Description |
pbReplicaId |
[in] ID de réplica pour lequel les métadonnées de réplica seront récupérées. |
pIdParameters |
[in] Schéma du format d'ID du fournisseur. |
ppReplicaMetadata |
[out] Retourne les métadonnées du réplica. |
Valeur de retour
S_OK.
E_POINTER.
E_OUTOFMEMORY.
E_UNEXPECTED si le magasin des métadonnées n'a pas encore été ouvert.
SYNC_E_METADATA_REPLICA_NOT_FOUND lorsqu'il n'existe pas de métadonnées pour l'ID de réplica spécifié.
SYNC_E_IDFORMATMISMATCH lorsque le schéma de format d'ID ne correspond pas à celui spécifié lors de l'initialisation des métadonnées de réplica.
SYNC_E_METADATA_REPLICA_IN_USE lorsqu'une instance de cet objet de métadonnées de réplica est déjà active.
Notes
Pour empêcher les applications d'effectuer des mises à jour simultanées conflictuelles dans le magasin des métadonnées, il n'est pas admis d'avoir plusieurs instances en attente de IReplicaMetadata pour un ID de réplica en particulier. Les applications peuvent accéder au même objet IReplicaMetadata à partir de plusieurs threads, mais plusieurs processus ne peuvent pas accéder aux mêmes métadonnées de réplica en même temps. S'il existe déjà une instance en attente de IReplicaMetadata pour un ID de réplica en particulier, cette méthode retourne SYNC_E_METADATA_REPLICA_IN_USE.