ISyncMetadataStore::GetReplicaMetadata
특정 복제본에 대한 메타데이터를 나타내는 IReplicaMetadata 개체를 가져옵니다.
HRESULT GetReplicaMetadata(
BYTE * pbReplicaId,
ID_PARAMETERS * pIdParameters,
IReplicaMetadata ** ppReplicaMetadata);
매개 변수
매개 변수 |
설명 |
pbReplicaId |
[in] 검색할 복제본 메타데이터의 복제본 ID입니다. |
pIdParameters |
[in] 공급자에 대한 ID 형식 스키마입니다. |
ppReplicaMetadata |
[out] 복제본에 대한 메타데이터를 반환합니다. |
반환 값
S_OK
E_POINTER
E_OUTOFMEMORY
메타데이터 저장소가 아직 열리지 않았으면 E_UNEXPECTED입니다.
지정한 복제본 ID에 대한 메타데이터가 없으면 SYNC_E_METADATA_REPLICA_NOT_FOUND입니다.
ID 형식 스키마가 복제본 메타데이터가 초기화할 때 지정된 ID 형식 스키마와 일치하지 않으면 SYNC_E_IDFORMATMISMATCH입니다.
이 복제본 메타데이터 개체의 인스턴스가 이미 활성 상태이면 SYNC_E_METADATA_REPLICA_IN_USE입니다.
주의
응용 프로그램이 메타데이터 저장소에 서로 충돌하는 업데이트 내용을 적용하지 않도록 특정 복제본 ID에 대해 처리 중인 IReplicaMetadata 인스턴스를 여러 개 사용할 수 없습니다. 응용 프로그램은 여러 스레드에서 동일한 IReplicaMetadata 개체에 액세스할 수 있지만 여러 프로세스에서 동시에 같은 복제본 메타데이터에 액세스할 수는 없습니다. 특정 복제본 ID에 대해 처리 중인 IReplicaMetadata 인스턴스가 이미 있는 경우 이 메서드는 SYNC_E_METADATA_REPLICA_IN_USE를 반환합니다.