ISyncMetadataStore::GetReplicaMetadata

Ruft das IReplicaMetadata-Objekt ab, das die Metadaten für ein bestimmtes Replikat darstellt.

HRESULT GetReplicaMetadata(
  BYTE * pbReplicaId,
  ID_PARAMETERS * pIdParameters,
  IReplicaMetadata ** ppReplicaMetadata);

Parameter

Parameter	Beschreibung
pbReplicaId	[in] Die Replikat-ID, für die Replikatmetadaten abgerufen werden.
pIdParameters	[in] Das ID-Formatschema für den Anbieter.
ppReplicaMetadata	[out] Gibt die Metadaten für das Replikat zurück.

Rückgabewert

• S_OK.

• E_POINTER.

• E_OUTOFMEMORY.

• E_UNEXPECTED, wenn der Metadatenspeicher noch nicht geöffnet wurde.

• SYNC_E_METADATA_REPLICA_NOT_FOUND, wenn keine Metadaten für die angegebene Replikat-ID vorhanden sind.

• SYNC_E_IDFORMATMISMATCH, wenn das ID-Formatschema nicht mit dem ID-Formatschema übereinstimmt, das bei der Initialisierung der Replikatmetadaten angegeben wurde.

• SYNC_E_METADATA_REPLICA_IN_USE, wenn eine Instanz dieses Replikatmetadaten-Objekts bereits aktiv ist.

Hinweise

Mehrere ausstehende Instanzen von IReplicaMetadata sind für eine bestimmte Replikat-ID nicht zulässig. Dadurch wird verhindert, dass Anwendungen Aktualisierungen am Metadatenspeicher vornehmen, die Parallelitätskonflikte auslösen. Anwendungen können von mehreren Threads aus auf das gleiche IReplicaMetadata-Objekt zugreifen. Mehrere Prozesse können jedoch nicht gleichzeitig auf die gleichen Replikatmetadaten zugreifen. Wenn bereits eine ausstehende Instanz von IReplicaMetadata für eine bestimmte Replikat-ID vorhanden ist, gibt diese Methode SYNC_E_METADATA_REPLICA_IN_USE zurück.

Siehe auch

Verweis

ISyncMetadataStore-Schnittstelle