IFileSyncProvider-Schnittstelle
Ist ein synchron gefilterter Synchronisierungsanbieter, der zum Synchronisieren von Dateien, Ordnern und Unterordnern in NTFS-, FAT- und SMB-Dateisystemen verwendet werden kann.
interface IFileSyncProvider : IKnowledgeSyncProvider
Member
| IFileSyncProvider-Methoden | Beschreibung |
|---|---|
Initialisiert eine neue Instanz von IFileSyncProvider, die auf dem zu synchronisierenden Ordner und weiteren Einstellungen basiert. |
|
Löst eine Auflistung der Änderungen des lokalen Dateisystemreplikats aus und aktualisiert die Metadaten entsprechend. |
|
Legt einen Wert fest, der angibt, ob sich der Anbieter im Vorschaumodus befindet. |
|
Erstellt ein neues IFileSyncScopeFilter-Objekt, das an Initialize übergeben werden kann, nachdem seine Filtereigenschaften festgelegt wurden. |
Hinweise
Um alle Dateien und Unterordner in einem Verzeichnis zu synchronisieren, übergeben Sie die Replikat-ID und das Stammverzeichnis an IFileSyncProvider::Initialize, übergeben Sie den Anbieter an IApplicationSyncServices::CreateSyncSession, und verwenden Sie das zurückgegebene ISyncSession-Objekt zum Behandeln der Synchronisierungssitzung.
Standardmäßig werden Synchronisierungsmetadaten in einer Metadaten-Speicherdienst-Datenbankdatei im Stammverzeichnis des Replikats gespeichert. Um den Speicherort und den Namen dieser Datei anzupassen, geben Sie diese mithilfe von Initialize an.
Welche Dateien und Ordner in den Synchronisierungsbereich eingeschlossen werden, kann gesteuert werden, indem ein IFileSyncScopeFilter-Objekt konfiguriert und an Initialize übergeben wird. Der Filter enthält Eigenschaften, mit deren Hilfe eine Liste von Dateien, eine Liste von Ordnern oder eine Liste von Ordnern und Dateien aufgrund ihrer Attribute ausgeschlossen oder eine Liste von Dateien explizit eingeschlossen werden kann.
Mit einer Reihe von Konfigurationsoptionen (FILESYNC_INIT_FLAGS) kann das Verhalten des Anbieters während der Synchronisierung gesteuert werden. Beispielsweise kann festgelegt werden, ob gelöschte Dateien in den Papierkorb verschoben oder endgültig aus dem Dateisystem gelöscht werden.
Für eine Anwendung, die den Status anzeigt oder während der Sitzung bestimmte Änderungen dynamisch überspringt, ist eine Reihe von Ereignissen verfügbar.
Der Anbieter kann in den Vorschaumodus versetzt werden, indem vor dem Starten der Synchronisierung TRUE an IFileSyncProvider::SetPreviewMode übergeben wird. Im Vorschaumodus führt der Anbieter alle Aktionen, einschließlich des Auslösens von Ereignissen, wie in einer tatsächlichen Synchronisierungssitzung aus. Der Anbieter übernimmt jedoch keine Änderungen für das Zielreplikat.
Hinweis
Gleichzeitige Synchronisierungsvorgänge für denselben Dateispeicher werden nicht unterstützt. Wenn bereits eine andere Anbieterinstanz mit demselben Replikat initialisiert wurde (also mit den gleichen Werten für den Verzeichnispfad und den Metadatendateipfad), diese jedoch noch nicht freigegeben wurde, gibt Initialize SYNC_METADATA_E_REPLICA_IN_USE zurück.
Anforderungen
Header: FileSyncProvider.h