IFileSyncProvider::Initialize
初始化以資料夾為依據執行同步處理和其他設定之 IFileSyncProvider 的新執行個體。
HRESULT Initialize(
REFGUID guidReplicaId,
LPCWSTR pcszReplicaRootPath,
LPCWSTR pcszMetadataFilePath,
LPCWSTR pcszTempDirectoryPath,
DWORD dwSyncFlags,
IFileSyncScopeFilter *pScopeFilter,
IFileSyncProviderCallback *pCallback,
LPCWSTR pcszPathToSaveConflictLoserFiles);
參數
- guidReplicaId
[in] 複寫的識別碼。
- 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 所指定複寫識別碼之 IReplicaMetadata 的執行個體和 pcszMetadataFilePath 所指定的中繼資料存放區，則為 SYNC_E_METADATA_REPLICA_IN_USE。
備註
傳遞給建構函式的資訊會用於初始化，而且會針對提供者執行個體的存留期來設定。這表示，當這些設定有任何變更時，就必須建立新的提供者執行個體。例如，若要變更用於同步處理的範圍篩選，就必須建立新的檔案同步處理提供者，並使用新的篩選將此提供者初始化。
檔案同步處理提供者會使用中繼資料儲存服務，將所有同步處理中繼資料儲存在輕量型資料庫中。中繼資料資料庫是一個檔案。這個檔案可以與要同步處理的檔案和資料夾存放在一起，或是放在 Initialize 所指定的另一個位置。
為確保適當的安全性，各種目錄 (例如暫存目錄) 必須用適當等級的安全性權限來確保安全，以防資訊外洩。