Verwenden des Synchronisierungs-Managers aus einem Programm

Damit Ihre Anwendung mit dem Synchronisierungs-Manager arbeiten kann, müssen Sie ein COM-Objekt (Component Object Model) implementieren, um Synchronisierungsbenachrichtigungen zu verarbeiten, die Sie von SyncMgr erhalten. Der Handler Ihrer Anwendung führt die Synchronisierung für die von Ihnen verarbeiteten Elemente durch. In Ihrem Handler enthalten, müssen Sie die ISyncMgrSynchronize-Schnittstelle implementieren. Außerdem müssen Sie ein Enumeratorobjekt und ISyncMgrEnumItems für alle separaten Elemente bereitstellen, die Ihre Anwendung synchronisieren kann.

SyncMgr implementiert ISyncMgrSynchronizeCallback und ISyncMgrSynchronizeInvoke.

SyncMgr ruft Methoden in ISyncMgrSynchronize auf, um Informationen zu den Elementen, die ihre Anwendung verarbeitet, sowie Informationen zu dem Handler abzurufen, den Sie für die Synchronisierung dieser Elemente bereitstellen.

Zur Laufzeit folgt der Synchronisierungsprozess den folgenden Schritten.

1. SyncMgr benachrichtigt Ihre Anwendung, dass die Synchronisierung für eines der Von der Anwendung behandelten Elemente erfolgt, indem die ISyncMgrSynchronize::Initialize-Methode aufgerufen wird.
2. SyncMgr ruft ISyncMgrSynchronize::EnumSyncMgrItems auf, um die ISyncMgrEnumItems-Schnittstelle für die von Ihrer Anwendung behandelten Elemente abzurufen.
3. SyncMgr ruft ISyncMgrSynchronize::SetProgressCallback auf, um ihrem Handler den Schnittstellenzeiger für die ISyncMgrSynchronizeCallback-Schnittstelle bereitzustellen. Ihr Handler verwendet diese Schnittstelle, um während der Synchronisierung zurück zur SyncMgr-Instanz aufzurufen.
4. SyncMgr ruft dann Ihre ISyncMgrSynchronize::P repareForSync-Methode auf, um ihrem Handler die Möglichkeit zu geben, alle Benutzeroberflächenelemente anzuzeigen, die vor Beginn der Synchronisierung erforderlich sind. Beispielsweise kann eine E-Mail-Anwendung ein Benutzeranmeldungsdialogfeld anzeigen.
5. Ihr Handler ruft ISyncMgrSynchronizeCallback::EnableModeless auf, bevor und nachdem Elemente der Benutzeroberfläche angezeigt werden. Ihr Handler ruft ISyncMgrSynchronizeCallback::P repareForSyncCompleted auf, wenn Sie fertig sind.
6. SyncMgr ruft Ihre ISyncMgrSynchronize::Synchronize-Methode auf, um die Synchronisierung zu starten.

Während des Synchronisierungsprozesses ruft SyncMgr weiterhin Methoden in Ihrer ISyncMgrSynchronize-Schnittstelle auf . Es kann Ihre Handlerfehler, Den Fortschritt und Benachrichtigungen senden. Es kann auch die Elemente aufzählen, die ihre Anwendung behandelt, oder es Ihrer Anwendung ermöglichen, Eigenschaften für die Elemente anzuzeigen.

Ihr Handler ruft Methoden in ISyncMgrSynchronizeCallback auf, um zu bestimmen, ob ein Element übersprungen werden soll, um Fehler zu protokollieren und Statusinformationen während des Synchronisierungsprozesses zu veröffentlichen.

Weitere Informationen finden Sie auf den entsprechenden Referenzseiten für die betreffenden Schnittstellen.

Wenn die Synchronisierung abgeschlossen ist, ruft Ihr Handler ISyncMgrSynchronizeCallback::SynchronizeCompleted auf.