Melden des Dateisynchronisierungsstatus
Eine Anwendung kann den Synchronisierungsstatus nachverfolgen, indem das Empfangen von während der Synchronisierung auftretenden Benachrichtigungen registriert wird.
Verwalteter Code Registrieren Sie Handler, um Ereignisse vom FileSyncProvider-Objekt zu erhalten, wie etwa CopyingFile, das periodisch auftritt, um den Fortschritt beim Kopieren einer Datei anzuzeigen, oder AppliedChange, das auftritt, wenn eine Dateiänderung übernommen wurde.
Nicht verwalteter Code Übergeben Sie ein IFileSyncProviderCallback-Objekt an die IFileSyncProvider::Initialize-Methode. Die IFileSyncProviderCallback-Methoden werden aufgerufen, wenn Ereignisse ausgelöst werden, wie etwa IFileSyncProviderCallback::OnFileCopyProgress, das periodisch auftritt, um den Fortschritt beim Kopieren einer Datei anzuzeigen, oder IFileSyncProviderCallback::OnChangeApplied, das auftritt, wenn eine Dateiänderung übernommen wurde.
Vorschaumodus
Die Anwendung kann für den Anbieter den Vorschaumodus festlegen, indem diese vor dem Start der Synchronisierung den Wert der PreviewMode-Eigenschaft auf true festlegt (für verwalteten Code), oder indem sie TRUE an die IFileSyncProvider::SetPreviewMode-Methode übergibt (für nicht verwalteten Code). Im Vorschaumodus erkennt der Anbieter Änderungen und löst Ereignisse aus wie bei einer üblichen Synchronisierungssitzung. Der Anbieter nimmt jedoch keine Änderungen am Zielreplikat vor und sendet nicht das AppliedChange-Ereignis (für verwalteten Code) oder das IFileSyncProviderCallback::OnChangeApplied-Ereignis (für nicht verwalteten Code).
Anzeigen des inkrementellen Fortschritts
Um während einer Synchronisierungssitzung den inkrementellen Fortschritt anzuzeigen, verwenden Sie die folgenden Prozeduren.
Verwalteter Code
Nehmen Sie eine Registrierung zum Behandeln des ApplyingChange-Ereignisses vor.
Aktivieren Sie den Vorschaumodus im Anbieter, indem Sie den Wert der PreviewMode-Eigenschaft auf true festlegen.
Führen Sie die Synchronisierung aus, und zählen Sie, wie häufig ApplyingChange ausgelöst wird.
Nehmen Sie eine Registrierung zum Verarbeiten des AppliedChange-Ereignisses vor.
Deaktivieren Sie den Vorschaumodus im Anbieter, indem Sie den Wert der PreviewMode-Eigenschaft auf false festlegen.
Führen Sie die Synchronisierung aus Wenn AppliedChange ausgelöst wird, kann der Synchronisierungsstatus bis zur Gesamtzahl der Änderungen inkrementiert werden, die während der Synchronisierung im Vorschaumodus gezählt wurden.
Nicht verwalteter Code
Registrieren Sie den Empfang des IFileSyncProviderCallback::OnApplyingChange-Rückrufs.
Aktivieren Sie den Vorschaumodus im Anbieter, indem Sie TRUE an die IFileSyncProvider::SetPreviewMode-Methode übergeben.
Führen Sie die Synchronisierung aus, und zählen Sie, wie häufig OnApplyingChange aufgerufen wird.
Registrieren Sie den Empfang des IFileSyncProviderCallback::OnChangeApplied-Rückrufs.
Deaktivieren Sie den Vorschaumodus im Anbieter, indem Sie FALSE an die IFileSyncProvider::SetPreviewMode-Methode übergeben.
Führen Sie die Synchronisierung aus. Wenn OnChangeApplied aufgerufen wird, kann der Synchronisierungsstatus bis zur Gesamtzahl der Änderungen inkrementiert werden, die während der Synchronisierung im Vorschaumodus gezählt wurden.
Siehe auch
Verweis
IFileSyncProviderCallback-Schnittstelle