Interface ISyncMgrUIOperation (syncmgr.h)

  • Article

Expose une méthode par le biais de laquelle un gestionnaire de synchronisation ou un élément de synchronisation peut afficher un objet d’interface utilisateur lorsque vous y êtes invité par le Centre de synchronisation.

Héritage

L’interface ISyncMgrUIOperation hérite de l’interface IUnknown. ISyncMgrUIOperation a également les types de membres suivants :

Méthodes

L’interface ISyncMgrUIOperation possède ces méthodes.

 
ISyncMgrUIOperation::Run

Effectue l’affichage réel de l’interface utilisateur pour un gestionnaire ou un élément de synchronisation lorsque vous y êtes invité par le Centre de synchronisation.

Remarques

Les gestionnaires implémentent ISyncMgrUIOperation pour fournir une interface utilisateur pour une action particulière. Chaque action distincte (parcourir, planifier, activer/désactiver, activer/désactiver et supprimer) nécessite une implémentation distincte.

Un gestionnaire doit implémenter cette interface uniquement pour les opérations pour lesquelles il souhaite présenter l’interface utilisateur.

L’exemple suivant récapitule les étapes que le Centre de synchronisation effectue pour instancier et utiliser cette interface.

  1. Le Centre de synchronisation crée un thread distinct pour l’opération d’interface utilisateur.
  2. Le Centre de synchronisation crée une nouvelle instance du gestionnaire.
  3. Si l’opération implique uniquement un gestionnaire, le Centre de synchronisation appelle ISyncMgrHandler::GetObject avec l’ID d’objet SYNCMGR_OBJECTID approprié pour obtenir un pointeur vers l’ISyncMgrUIOperation qui implémente cet objet d’interface utilisateur. Par exemple, le Centre de synchronisation appelle ISyncMgrHandler::GetObject avec SYNCMGR_OBJECTID_QueryBeforeDelete pour obtenir un objet appelé pour afficher l’interface utilisateur lorsque l’utilisateur choisit de supprimer le gestionnaire, en demandant une confirmation qu’il souhaite effectivement le supprimer.
  4. Si l’opération implique un élément de synchronisation, le Centre de synchronisation effectue une série d’appels, notamment les suivants :
    1. QueryInterface est appelé sur l’interface ISyncMgrHandler pour récupérer un instance d’ISyncMgrSyncItemContainer.
    2. ISyncMgrSyncItemContainer::GetSyncItem est appelé pour obtenir un pointeur vers le instance ISyncMgrSyncItem représentant l’élément.
    3. ISyncMgrSyncItem::GetObject est appelé avec l’ID d’objet SYNCMGR_OBJECTID approprié pour obtenir un pointeur vers l’ISyncMgrUIOperation qui implémente l’objet d’interface utilisateur.
  5. Le Centre de synchronisation appelle la méthode Run de l’objet d’interface utilisateur pour afficher l’interface utilisateur.
En implémentant l’interface utilisateur en tant qu’interface distincte, l’affichage de l’interface utilisateur peut être effectué indépendamment de la synchronisation. ISyncMgrUIOperation doit être implémenté sur un autre objet que ISyncMgrHandler ou ISyncMgrSyncItem.

Si l’utilisateur demande une action, puis demande cette même action à nouveau avant que la première ne soit terminée, l’interface utilisateur de l’action initiale est activée et mise au premier plan.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête syncmgr.h