Utilisation du gestionnaire de synchronisation à partir d’un programme

Pour permettre à votre application de fonctionner avec le gestionnaire de synchronisation, vous devez implémenter un objet COM (Component Object Model) pour gérer les notifications de synchronisation que vous recevez de SyncMgr. Le gestionnaire de votre application effectue la synchronisation pour les éléments que vous gérez. Inclus dans votre gestionnaire, vous devez implémenter l’interface ISyncMgrSynchronize . En outre, vous devez fournir un objet énumérateur et ISyncMgrEnumItems pour tous les éléments séparés que votre application peut synchroniser.

SyncMgr implémente ISyncMgrSynchronizeCallback et ISyncMgrSynchronizeInvoke.

SyncMgr appelle les méthodes de votre ISyncMgrSynchronize pour obtenir des informations sur les éléments que votre application gère et les informations sur le gestionnaire que vous fournissez pour synchroniser ces éléments.

Au moment de l’exécution, le processus de synchronisation suit ces étapes.

  1. SyncMgr informe votre application qu’il est temps que la synchronisation se produise pour l’un des éléments que votre application gère en appelant votre méthode ISyncMgrSynchronize :: Initialize .
  2. SyncMgr appelle ISyncMgrSynchronize :: EnumSyncMgrItems pour obtenir l’interface ISyncMgrEnumItems pour les éléments gérés par votre application.
  3. SyncMgr appelle ISyncMgrSynchronize :: SetProgressCallback pour fournir votre gestionnaire avec le pointeur d’interface pour l’interface ISyncMgrSynchronizeCallback . Votre gestionnaire utilise cette interface pour rappeler le SyncMgr pendant la synchronisation.
  4. SyncMgr appelle ensuite votre méthode ISyncMgrSynchronize ::P repareforsync pour permettre à votre gestionnaire d’afficher n’importe quel élément d’interface utilisateur nécessaire avant le début de la synchronisation. Par exemple, une application de messagerie peut afficher une boîte de dialogue d’ouverture de session utilisateur.
  5. Votre gestionnaire appelle ISyncMgrSynchronizeCallback :: EnableModeless avant et après l’affichage des éléments d’interface utilisateur. Votre gestionnaire appelle ISyncMgrSynchronizeCallback ::P repareforsynccompleted lorsque vous avez terminé.
  6. SyncMgr appelle votre méthode ISyncMgrSynchronize :: Synchronize pour démarrer la synchronisation.

Pendant le processus de synchronisation, SyncMgr continue d’appeler des méthodes dans votre interface ISyncMgrSynchronize . Il peut envoyer vos erreurs de gestionnaire, la progression et les notifications. Il peut également énumérer les éléments que votre application gère ou autoriser votre application à afficher les propriétés des éléments.

Votre gestionnaire appelle des méthodes dans ISyncMgrSynchronizeCallback pour déterminer si un élément doit être ignoré, pour consigner les erreurs et pour poster des informations de progression pendant le processus de synchronisation.

Pour plus d’informations, consultez les pages de référence associées pour les interfaces impliquées.

Une fois la synchronisation terminée, votre gestionnaire appelle ISyncMgrSynchronizeCallback :: SynchronizeCompleted.