IFileSyncScopeFilter 介面

定義篩選，可用篩選來從靜態同步處理範圍併入或排除檔案和資料夾。

interface IFileSyncScopeFilter : IUnknown

成員

IFileSyncScopeFilter 方法	描述
IFileSyncScopeFilter::SetFilenameExcludes	設定要從範圍中排除的檔案名稱集合。
IFileSyncScopeFilter::SetSubDirectoryExcludes	設定要從範圍中排除之目錄的相對路徑集合。
IFileSyncScopeFilter::SetFileAttributeExcludeMask	設定用來從範圍中排除檔案和資料夾的屬性。
IFileSyncScopeFilter::SetFilenameIncludes	設定要明確包含在範圍中的檔案名稱集合。
IFileSyncScopeFilter::GetFilenameExcludes	取得要從範圍中排除的檔案名稱集合。
IFileSyncScopeFilter::GetSubDirectoryExcludes	取得要從範圍中排除之目錄的相對路徑集合。
IFileSyncScopeFilter::GetFileAttributeExcludeMask	取得用來從範圍中排除檔案和資料夾的屬性。
IFileSyncScopeFilter::GetFilenameIncludes	取得要明確包含在範圍中的檔案名稱集合。

備註

靜態篩選是使用在變更偵測期間，而且會同樣套用到同步處理範圍內的所有項目。如果項目要包含在同步處理內，必須將所有靜態篩選傳遞給它。例如，如果某個檔案同時被明確排除在外及明確包含在內，該檔案就會被排除在範圍之外。

相同的範圍篩選應該用於同步處理社群內的所有提供者上。如果不是這樣，可能會發生非預期的行為。

傳遞給 IFileSyncProvider::Initialize 的篩選是用來根據傳入時的範圍篩選來初始化提供者物件。此篩選的後續變更將不會影響此提供者執行個體所使用的範圍篩選。若要變更使用的範圍篩選，您必須建立新的 IFileSyncProvider 物件。

在第一次同步處理之後變更複寫的範圍可能會產生非預期的副作用。例如，假設您在第一次同步處理之後的某個時間，將複寫 A 的範圍變更為開始排除 *.txt。如此會使複寫 A 將所有副檔名為 .txt 的檔案視為已刪除。實際上不會從複寫 A 中刪除任何檔案；但是，複寫 A 的中繼資料將會包含 .txt 檔案的標記，而複寫 A 會將刪除變更傳送給 .txt 檔案的其他複寫。如果您也在複寫 B 中排除 *.txt，則不會有任何影響，因為複寫 B 將會從複寫 A 中篩選屬於 .txt 檔案的變更。但是，如果複寫 B 不變更它的篩選，已刪除的檔案將會流向它、視為真正的變更要求，然後從複寫 B 中刪除。

需求

標頭： Filesyncprovider.h

請參閱

概念

Sync Framework 檔案同步處理元件