ISyncMgrSynchronize::Synchronize-Methode (mobsync.h)
Wird vom Synchronisierungs-Manager einmal für jede ausgewählte Gruppe aufgerufen, nachdem der Benutzer die registrierten Anwendungen ausgewählt hat, die synchronisiert werden sollen.
Syntax
HRESULT Synchronize(
[in] HWND hWndParent
);
Parameter
[in] hWndParent
Typ: HWND
Ein Handle für den übergeordneten HWND , den die registrierte Anwendung für alle angezeigten Benutzeroberflächenelemente verwenden sollte. Dieser Wert kann NULL sein.
Rückgabewert
Typ: HRESULT
Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie Folgendes:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Synchronisierung war erfolgreich. |
|
Fehler bei der Synchronisierung. |
Hinweise
Wenn der Benutzer keine Elementauswahl für die registrierte Anwendung auswählt, wird die ISyncMgrSynchronize::Synchronize-Methode nicht aufgerufen, und die Schnittstelle wird freigegeben. Wenn diese Methode aufgerufen wird, muss die Anwendung die Elemente synchronisieren, die in der ISyncMgrSynchronize::P repareForSync-Methode angegeben wurden.
Der Handler der registrierten Anwendung sollte so bald wie möglich von der ISyncMgrSynchronize::Synchronize-Methode zurückgegeben und dann die SynchronizeCompleted-Methode aufrufen. Es ist akzeptabel, dass der Handler den SynchronizeCompleted-Aufruf aufruft , bevor er von der ISyncMgrSynchronize::Synchronize-Methode zurückgibt.
Die Anwendung muss Statusfeedback geben und überprüfen, ob die Synchronisierung abgebrochen werden soll, indem der pSyncCallBack-Schnittstellenzeiger verwendet wird, der in der ISyncMgrSynchronize::SetProgressCallback-Methode eingerichtet wurde.
Anwendungen müssen Statusinformationen bereitstellen, auch wenn das SYNCMGRFLAG_MAYBOTHERUSER-Flag nicht in ISyncMgrSynchronize::Initialize angegeben wurde.
Anwendungen sollten nicht versuchen, Benutzeroberflächenelemente aus der ISyncMgrSynchronize::Synchronize-Methode anzuzeigen. Alle Benutzeroberflächenelemente sollten in den Methoden ISyncMgrSynchronize::P repareForSync und ISyncMgrSynchronize::ShowError angezeigt werden, damit der Endbenutzer eine konsistente Benutzeroberfläche erhält, die auf die Anmeldung und die Angabe der zu synchronisierenden Freigaben beschränkt ist. Anschließend kann die Synchronisierung ohne Benutzereingriff durchgeführt werden. Nach Abschluss der Synchronisierung können Konflikte oder andere Fehlermeldungen angezeigt werden.
Die ISyncMgrSynchronizeCallback-Methoden können für jeden Thread in Ihrer Anwendung aufgerufen werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mobsync.h |
| DLL | Mobsync.dll |
Weitere Informationen
ISyncMgrSynchronize::Initialize
ISyncMgrSynchronize::P repareForSync
ISyncMgrSynchronize::SetProgressCallback