다음을 통해 공유


ISyncMetadataStore::GetReplicaMetadata

특정 복제본에 대한 메타데이터를 나타내는 IReplicaMetadata 개체를 가져옵니다.

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

매개 변수

  • pbReplicaId
    [in] 검색할 복제본 메타데이터의 복제본 ID입니다.
  • idParameters
    [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를 반환합니다.

참고 항목

참조

ISyncMetadataStore 인터페이스