IFileSyncProvider 인터페이스
NTFS, FAT 또는 SMB 파일 시스템의 파일, 폴더 및 하위 폴더를 동기화하는 데 사용할 수 있는 동기 필터링된 동기화 공급자입니다.
interface IFileSyncProvider : IKnowledgeSyncProvider
멤버
| IFileSyncProvider 메서드 | 설명 |
|---|---|
동기화할 폴더 및 기타 설정을 기반으로 하는 IFileSyncProvider의 새 인스턴스를 초기화합니다. |
|
로컬 파일 시스템 복제본의 변경 내용에 대한 열거 작업을 트리거하며 메타데이터를 적절하게 업데이트합니다. |
|
공급자가 미리 보기 모드에 있는지 여부를 나타내는 값을 설정합니다. |
|
필터 속성을 설정한 후 Initialize로 전달할 수 있는 새 IFileSyncScopeFilter 개체를 만듭니다. |
주의
디렉터리의 모든 파일 및 하위 폴더를 동기화하려면 복제본 ID와 루트 디렉터리를 IFileSyncProvider::Initialize에 전달하고 공급자를 IApplicationSyncServices::CreateSyncSession에 전달한 다음, 반환된 ISyncSession 개체를 사용하여 동기화 세션을 처리합니다.
기본적으로 동기화 메타데이터는 복제본의 루트 디렉터리에 있는 Metadata Storage Service 데이터베이스 파일에 저장됩니다. 이 파일의 위치와 이름을 사용자 지정하려면 Initialize를 사용하면 됩니다.
동기화 범위에 포함되는 파일 및 폴더는 IFileSyncScopeFilter 개체를 구성한 다음 이 개체를 Initialize에 전달하여 제어할 수 있습니다. 필터에는 파일 목록을 제외하고, 폴더 목록을 제외하고, 해당 특성을 기반으로 파일 및 폴더를 제외하고, 파일 목록을 명시적으로 포함하는 데 사용할 수 있는 속성이 포함되어 있습니다.
많은 구성 옵션(FILESYNC_INIT_FLAGS)을 사용하여 삭제된 파일을 휴지통으로 이동할지, 아니면 파일 시스템에서 영구적으로 삭제할지 등 동기화하는 동안의 공급자 동작을 제어할 수 있습니다.
다양한 이벤트를 응용 프로그램에서 사용하여 세션을 진행하는 동안 진행률을 표시하거나 특정 변경 내용을 동적으로 건너뛸 수 있습니다.
동기화를 시작하기 전에 IFileSyncProvider::SetPreviewMode에 TRUE를 전달하여 공급자를 미리 보기 모드로 전환할 수 있습니다. 공급자는 미리 보기 모드에 있는 동안 실제 동기화 세션이 발생하고 있는 것처럼 모든 이벤트를 발생시키는 것과 같은 모든 동작을 수행합니다. 그러나 공급자는 대상 복제본에 어떠한 변경 내용도 실제로 적용하지 않습니다.
참고
동일한 파일 저장소에 대해 동시에 동기화 작업을 수행할 수는 없습니다. 다른 공급자 인스턴스가 이전에 동일한 복제본(동일한 디렉터리 경로 및 메타데이터 파일 경로)으로 초기화되었지만 아직 해제되지 않은 경우 Initialize는 SYNC_METADATA_E_REPLICA_IN_USE를 반환합니다.
요구 사항
헤더: FileSyncProvider.h