ISyncMgrSynchronize::Synchronize, méthode (mobsync.h)

Article
08/24/2023

Appelé par le gestionnaire de synchronisation une fois pour chaque groupe sélectionné une fois que l’utilisateur a choisi les applications inscrites à synchroniser.

Syntaxe

HRESULT Synchronize(
  [in] HWND hWndParent
);

Paramètres

[in] hWndParent

Type : HWND

Handle du HWND parent que l’application inscrite doit utiliser pour tous les éléments d’interface utilisateur qu’elle affiche. Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Cette méthode prend en charge les valeurs de retour standard, E_INVALIDARG, E_UNEXPECTED et E_OUTOFMEMORY, ainsi que les éléments suivants :

Code de retour	Description
S_OK	La synchronisation a réussi.
E_FAIL	Échec de la synchronisation.

Notes

Si l’utilisateur ne sélectionne aucun élément pour l’application inscrite, la méthode ISyncMgrSynchronize::Synchronize n’est pas appelée et l’interface est libérée. Si cette méthode est appelée, l’application doit synchroniser les éléments spécifiés dans la méthode ISyncMgrSynchronize::P repareForSync .

Le gestionnaire de l’application inscrite doit retourner à partir de la méthode ISyncMgrSynchronize::Synchronize dès que possible, puis appeler la méthode SynchronizeCompleted . Il est acceptable que le gestionnaire appelle l’appel SynchronizeCompleted avant de retourner à partir de la méthode ISyncMgrSynchronize::Synchronize .

L’application doit fournir des commentaires sur la progression et case activée si la synchronisation doit être annulée à l’aide du pointeur d’interface pSyncCallBack qui a été configuré dans la méthode ISyncMgrSynchronize::SetProgressCallback.

Les applications doivent fournir des informations sur la progression même si l’indicateur SYNCMGRFLAG_MAYBOTHERUSER n’a pas été spécifié dans ISyncMgrSynchronize::Initialize.

Les applications doivent essayer de ne pas afficher les éléments d’interface utilisateur à partir de la méthode ISyncMgrSynchronize::Synchronize . Tous les éléments d’interface utilisateur doivent être affichés dans les méthodes ISyncMgrSynchronize::P repareForSync et ISyncMgrSynchronize::ShowError afin que l’utilisateur final bénéficie d’une interface utilisateur cohérente qui se limite à l’ouverture de session et à la spécification des partages à synchroniser. Par la suite, la synchronisation peut être effectuée sans aucune intervention de l’utilisateur. Une fois la synchronisation terminée, des conflits ou d’autres messages d’erreur peuvent être affichés.

Les méthodes ISyncMgrSynchronizeCallback peuvent être appelées sur n’importe quel thread de votre application.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mobsync.h
DLL	Mobsync.dll