ISyncMgrSynchronize::Synchronize-Methode (mobsync.h)

Artikel
08/24/2023

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
S_OK	Die Synchronisierung war erfolgreich.
E_FAIL	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