IFileSyncProvider::Initialize
동기화할 폴더 및 기타 설정을 기반으로 하는 IFileSyncProvider의 새 인스턴스를 초기화합니다.
HRESULT Initialize(
REFGUID guidReplicaId,
LPCWSTR pcszReplicaRootPath,
LPCWSTR pcszMetadataFilePath,
LPCWSTR pcszTempDirectoryPath,
DWORD dwSyncFlags,
IFileSyncScopeFilter *pScopeFilter,
IFileSyncProviderCallback *pCallback,
LPCWSTR pcszPathToSaveConflictLoserFiles);
매개 변수
- guidReplicaId
[in] 복제본의 ID입니다.
- pcszReplicaRootPath
[in, string] 이 공급자의 로컬 파일 저장소에 대한 절대 경로입니다. 이 폴더는 동기화할 파일 및 하위 폴더가 들어 있는 폴더입니다.
- pcszMetadataFilePath
[in, string] 메타데이터 저장소 파일의 절대 경로 및 파일 이름입니다. 이 생성자를 호출하려면 먼저 해당 디렉터리를 만들어야 합니다. 응용 프로그램에서 적절한 보안 권한 수준으로 이 디렉터리에 보안을 설정하여 정보가 공개되지 않도록 해야 합니다.
- pcszTempDirectoryPath
[in, unique, string] 임시 파일을 저장할 절대 경로입니다. 이 생성자를 호출하려면 먼저 해당 디렉터리를 만들어야 합니다. 응용 프로그램에서 적절한 보안 권한 수준으로 이 디렉터리에 보안을 설정하여 정보가 공개되지 않도록 해야 합니다. pcszTempDirectoryPath가 NULL이거나 빈 문자열이면 임시 파일은 pcszReplicaRootPath에 지정된 위치에 저장됩니다.
- dwSyncFlags
[in] 동기화하는 동안의 공급자 동작을 결정하는 플래그입니다. 이 값은 FILESYNC_INIT_FLAGS 열거형 값의 조합이어야 합니다.
- pScopeFilter
[in, unique] 로컬 파일 저장소에서 범위에 포함될 파일 또는 디렉터리를 지정하는 정적 범위 필터입니다. NULL일 수 있습니다.
- pCallback
[in, unique] 공급자로부터 진행률 및 상태 알림을 받는 콜백 인터페이스입니다. NULL일 수 있습니다.
- pcszPathToSaveConflictLoserFiles
[in, string] 충돌에서 밀리는 파일이 저장될 절대 경로입니다. 이 생성자를 호출하려면 먼저 해당 디렉터리를 만들어야 합니다. 응용 프로그램에서 적절한 보안 권한 수준으로 이 디렉터리에 보안을 설정하여 정보가 공개되지 않도록 해야 합니다. NULL일 수 있습니다.
반환 값
S_OK
Initialize가 이미 호출되었으면 SYNC_E_FSP_INVALIDOPERATION입니다.
지정된 경로가 상대 경로이거나 없는 경우 또는 메타데이터 경로에 메타데이터 파일 이름이 포함되지 않은 경우에는 E_INVALIDARG입니다.
guidReplicaId에 지정된 복제본 ID 및 pcszMetadataFilePath에 지정된 메타데이터 저장소를 나타내는 IReplicaMetadata 인스턴스가 이미 다른 프로세스에 있으면 SYNC_E_METADATA_REPLICA_IN_USE입니다.
주의
생성자에 전달된 정보는 초기화에 사용되며 공급자 인스턴스의 수명 동안 설정됩니다. 즉, 이러한 설정을 변경할 경우 공급자의 새 인스턴스를 만들어야 합니다. 예를 들어 동기화에 사용되는 범위 필터를 변경하려면 새 File Synchronization Provider를 만들고 새 필터를 사용하여 초기화해야 합니다.
File Synchronization Provider는 Metadata Storage Service를 사용하여 모든 동기화 메타데이터를 간단한 데이터베이스에 저장합니다. 메타데이터 데이터베이스는 단일 파일입니다. 이 파일은 동기화할 파일 및 폴더와 함께 저장하거나 Initialize에 지정된 다른 위치에 저장할 수 있습니다.
임시 디렉터리와 같은 디렉터리의 보안을 적절한 권한 수준으로 설정하여 정보가 공개되지 않도록 해야 합니다.