IFileSyncScopeFilter-Schnittstelle
Definiert Filter, mit denen Dateien und Ordner im statischen Synchronisierungsbereich ein- oder ausgeschlossen werden können.
interface IFileSyncScopeFilter : IUnknown
Member
| IFileSyncScopeFilter-Methoden | Beschreibung |
|---|---|
Legt die Auflistung von Dateinamen fest, die aus dem Bereich ausgeschlossen werden sollen. |
|
Legt die Auflistung relativer Pfade von Verzeichnissen fest, die aus dem Bereich ausgeschlossen werden sollen. |
|
Legt die Attribute fest, mit denen Dateien und Ordner aus dem Bereich ausgeschlossen werden. |
|
Legt die Auflistung von Dateinamen fest, die explizit in den Bereich eingeschlossen werden sollen. |
|
Ruft die Auflistung von Dateinamen ab, die aus dem Bereich ausgeschlossen werden sollen. |
|
Ruft eine Auflistung relativer Pfade von Verzeichnissen ab, die aus dem Bereich ausgeschlossen werden sollen. |
|
Ruft die Attribute ab, mit denen Dateien und Ordner aus dem Bereich ausgeschlossen werden. |
|
Ruft die Auflistung von Dateinamen ab, die explizit in den Bereich eingeschlossen werden sollen. |
Hinweise
Die statischen Filter werden während der Änderungserkennung verwendet und gleichmäßig auf alle Elemente im Synchronisationsbereich angewendet. Damit ein Element in der Synchronisierung einbezogen wird, muss es allen statischen Filter genügen. Wenn eine Datei beispielsweise sowohl explizit eingeschlossen als auch explizit ausgeschlossen ist, wird die Datei aus dem Bereich ausgeschlossen.
Für alle Anbieter einer Synchronisierungscommunity sollte der gleiche Bereichsfilter verwendet werden. Ist dies nicht der Fall, können Probleme auftreten.
Mit dem an IFileSyncProvider::Initialize übergebenen Filter wird das Anbieterobjekt beim Übergeben dem Bereichsfilter entsprechend initialisiert. Spätere Veränderungen des Filters beeinflussen den Bereichsfilter, der von dieser Instanz des Anbieters verwendet wird, nicht. Um den verwendeten Bereichsfilter zu ändern, müssen Sie ein neues IFileSyncProvider-Objekt erstellen.
Wenn Sie den Bereich eines Replikats nach der ersten Synchronisierung ändern, kann dies unerwünschte Nebeneffekte zur Folge haben. Angenommen, Sie ändern nach der ersten Synchronisierung den Bereich eines Replikats A, um fortan TXT-Dateien auszuschließen. Dies führt dazu, dass alle Dateien mit TXT-Erweiterung von Replikat A als gelöscht behandelt werden. Tatsächlich werden keine Dateien aus Replikat A gelöscht. Metadaten für A enthalten jedoch Tombstones für TXT-Dateien, und für die TXT-Dateien werden Löschänderungen von A an andere Replikate gesendet. Wenn Sie TXT-Dateien auch für Replikat B ausschließen, hat dies keine Auswirkungen, da B Änderungen von A, die für TXT-Dateien gelten, filtert. Wenn der Filter von Replikat B jedoch nicht geändert wird, werden die gelöschten Dateien auf dieses Replikat geleitet, als echte Veränderungsanforderungen behandelt und von Replikat B gelöscht.
Anforderungen
Header: Filesyncprovider.h