這是同步篩選的同步處理提供者，可用來同步處理 NTFS、FAT 或 SMB 檔案系統中的檔案、資料夾和子資料夾。
interface IFileSyncProvider : IKnowledgeSyncProvider
成員
| IFileSyncProvider 方法 | 描述 |
|---|---|
初始化以資料夾為依據執行同步處理和其他設定之 IFileSyncProvider 的新執行個體。 |
|
針對變更觸發本機檔案系統複寫的列舉，並適當地更新中繼資料。 |
|
設定表示此提供者是否處於預覽模式的值。 |
|
建立可以在其篩選屬性後設定傳遞給 Initialize 的新 IFileSyncScopeFilter 物件。 |
備註
若要同步處理目錄中的所有檔案和子資料夾，請將複寫識別碼和根目錄傳遞給 IFileSyncProvider::Initialize，將提供者傳遞給 IApplicationSyncServices::CreateSyncSession，並且使用傳回的 ISyncSession 物件來處理同步處理工作階段。
根據預設，同步處理中繼資料是儲存在複寫根目錄的中繼資料儲存服務資料庫檔案中。若要自訂這個檔案的位置和名稱，請使用 Initialize 來指定這些項目。
設定 IFileSyncScopeFilter 物件並將它傳遞給 passing it to Initialize，就可以控制同步處理範圍中要包含哪些檔案和資料夾。篩選包含了可用來排除檔案清單、排除資料夾清單、排除檔案和資料夾 (根據其屬性 (Attribute)) 及明確包含檔案清單的屬性 (Property)。
有一些組態選項 (FILESYNC_INIT_FLAGS) 可用來控制同步處理期間的提供者行為，例如，它是否會將已刪除的檔案移到資源回收筒，或是從檔案系統中永久刪除。
有提供各種事件給工作階段期間想要顯示進度或是動態跳過特定變更的應用程式使用。
在開始同步處理之前將 TRUE 傳遞給 IFileSyncProvider::SetPreviewMode，便可將提供者置於預覽模式。當提供者在預覽模式時，將會執行所有的動作，就像是真正的同步處理工作階段正在發生一樣，包括引發所有事件。但是，提供者實際上不會將任何變更套用到目的地複寫。
注意
不支援對相同的檔案存放區進行並行的同步處理作業。如果之前有另一個提供者執行個體已經使用相同的複寫初始化 (也就是目錄路徑和中繼資料檔案路徑的相同值)，但是尚未釋放，Initialize 將會傳回 SYNC_METADATA_E_REPLICA_IN_USE。
需求
標頭： FileSyncProvider.h