ISqlSyncMetadataStore 인터페이스

저장소로 간단한 데이터베이스를 사용하는 메타데이터 저장소를 나타냅니다.

interface ISqlSyncMetadataStore : ISyncMetadataStore2

멤버

ISqlSyncMetadataStore 메서드	설명
ISqlSyncMetadataStore::CreateStore	메타데이터 저장소 파일과 이 파일을 나타내는 메타데이터 저장소 개체를 만듭니다.
ISqlSyncMetadataStore::OpenStore	기존 메타데이터 저장소 파일을 열고 이를 나타내는 메타데이터 저장소 개체를 반환합니다.
ISqlSyncMetadataStore::Dispose	ISqlSyncMetadataStore 개체에서 사용하는 리소스를 해제합니다.

주의

Metadata Storage Service는 경량 데이터베이스를 사용하여 파일 시스템의 지정된 위치에 있는 하나의 데이터베이스 파일에 동기화에 필요한 모든 메타데이터를 저장하는 Metadata Storage Service API를 완전히 구현합니다. 이 구현의 진입점은 ISqlSyncMetadataStore입니다. 이 인터페이스를 구현하는 개체를 가져오려면 CLSID_SyncMetadataStore 및 IID_ISqlSyncMetadataStore를 CoCreateInstance 함수에 전달합니다.

Metadata Storage Service API 구현을 사용하려면

ISqlSyncMetadataStore::CreateStore를 사용하여 새 메타데이터 저장소를 만들거나 ISqlSyncMetadataStore::OpenStore를 사용하여 기존 메타데이터 저장소를 엽니다. ISyncMetadataStore::InitializeReplicaMetadata를 사용하여 지정된 복제본의 메타데이터를 만들거나 ISyncMetadataStore::GetReplicaMetadata를 사용하여 기존 복제본 메타데이터를 엽니다. GetReplicaMetadata는 메타데이터 저장소에 저장된 복제본 메타데이터에 액세스할 수 있는 IReplicaMetadata의 구현을 반환합니다. ISyncMetadataStore::BeginTransaction을 사용하여 데이터베이스 트랜잭션을 시작합니다. 이렇게 하면 이 메서드를 호출한 후 메타데이터에 대해 수행한 변경 내용이 데이터베이스에 모두 저장되거나 전혀 저장되지 않게 할 수 있습니다. IReplicaMetadata::CreateNewItemMetadata를 사용하여 새 항목 메타데이터를 만들거나 IReplicaMetadata::FindItemMetadataByGlobalId와 같은 메서드를 사용하여 개별 항목에 대한 메타데이터를 찾습니다. 이러한 메서드는 메타데이터 저장소에 저장된 항목 메타데이터에 액세스할 수 있는 IItemMetadata의 구현을 반환합니다. 항목 메타데이터를 변경한 다음 IReplicaMetadata::SaveItemMetadata를 사용하여 해당 변경 내용을 저장합니다. ISyncMetadataStore::CommitTransaction을 호출하여 메타데이터 저장소에 대한 변경 내용을 커밋하거나 ISyncMetadataStore::RollbackTransaction을 호출하여 변경 내용을 취소합니다.

API를 이렇게 구현하면 IReplicaMetadata 개체의 메서드를 통해 항목 저장소에서 삭제한 항목을 검색할 수도 있습니다. 예를 들어 IReplicaMetadata::GetUnreportedItems는 메타데이터 저장소에는 있지만 항목 저장소에는 없는 항목 목록을 반환합니다. 그러면 공급자는 메타데이터 저장소에서 이 목록에 있는 항목을 삭제 표식으로 표시할 수 있습니다.

요구 사항

헤더: Metastore.h

참고 항목

개념

Sync Framework Metadata Storage Service 구성 요소
메타데이터 저장 시작