énumération SYNCMGR_HANDLER_CAPABILITIES (syncmgr.h)

Article
03/02/2024

Spécifie les fonctionnalités d’un gestionnaire concernant les actions qui peuvent être effectuées sur celui-ci.

Syntax

typedef enum SYNCMGR_HANDLER_CAPABILITIES {
  SYNCMGR_HCM_NONE = 0,
  SYNCMGR_HCM_PROVIDES_ICON = 0x1,
  SYNCMGR_HCM_EVENT_STORE = 0x2,
  SYNCMGR_HCM_CONFLICT_STORE = 0x4,
  SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS = 0x10,
  SYNCMGR_HCM_CAN_BROWSE_CONTENT = 0x10000,
  SYNCMGR_HCM_CAN_SHOW_SCHEDULE = 0x20000,
  SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE = 0x100000,
  SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE = 0x200000,
  SYNCMGR_HCM_QUERY_BEFORE_ENABLE = 0x400000,
  SYNCMGR_HCM_QUERY_BEFORE_DISABLE = 0x800000,
  SYNCMGR_HCM_VALID_MASK = 0xf30017
} ;

Constantes


`SYNCMGR_HCM_NONE` Valeur : 0 Aucun indicateur de capacité n’est défini.
`SYNCMGR_HCM_PROVIDES_ICON` Valeur : 0x1 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_Icon. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter IExtractIcon. En règle générale, cette valeur ne doit pas être retournée si possible.
`SYNCMGR_HCM_EVENT_STORE` Valeur : 0x2 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_EventStore. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrEventStore.
`SYNCMGR_HCM_CONFLICT_STORE` Valeur : 0x4 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_ConflictStore. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrConflictStore.
`SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS` Valeur : 0x10 Si un gestionnaire définit cet indicateur dans le masque retourné par la méthode ISyncMgrHandler ::GetCapabilities du gestionnaire, cela indique que le gestionnaire prévoit de créer plusieurs sessions de synchronisation simultanées à l’aide de ISyncMgrSessionCreator ::CreateSession. Cela est utile pour les gestionnaires qui implémentent une architecture de synchronisation en arrière-plan dans laquelle le gestionnaire signale simplement à un autre processus d’effectuer la synchronisation au lieu d’effectuer la synchronisation directement dans sa méthode ISyncMgrHandler ::Synchronize . Cela permet aux moteurs de synchronisation de signaler la progression, les conflits et les événements (via ISyncMgrSyncCallback) lorsque les demandes de synchronisation proviennent de sources autres que le Centre de synchronisation. Par exemple, cela peut être le résultat d’une notification de modification de données ou d’une interface utilisateur spécifique à l’application. Si plusieurs sessions synchronisent le même élément, la progression de cet élément est signalée comme indéterminée.
`SYNCMGR_HCM_CAN_BROWSE_CONTENT` Valeur : 0x10000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_BrowseContent. Si cette valeur est définie, la tâche Parcourir le contenu est ajoutée au menu contextuel du gestionnaire. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation.
`SYNCMGR_HCM_CAN_SHOW_SCHEDULE` Valeur : 0x20000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_ShowSchedule. Si cette valeur est définie, la tâche Afficher la planification est ajoutée au menu contextuel du gestionnaire. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation. Cette valeur est utilisée par ISyncMgrScheduleWizardUIOperation.
`SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE` Valeur : 0x100000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_QueryBeforeActivate. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation.
`SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE` Valeur : 0x200000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_QueryBeforeDeactivate. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation.
`SYNCMGR_HCM_QUERY_BEFORE_ENABLE` Valeur : 0x400000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_QueryBeforeEnable. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation.
`SYNCMGR_HCM_QUERY_BEFORE_DISABLE` Valeur : 0x800000 Le gestionnaire retourne un objet valide à partir d’ISyncMgrHandler ::GetObject lorsque cette méthode est appelée avec l’indicateur SYNCMGR_OBJECTID_QueryBeforeDisable. L’objet retourné par ISyncMgrHandler ::GetObject doit implémenter ISyncMgrUIOperation.
`SYNCMGR_HCM_VALID_MASK` Valeur : 0xf30017 Masque utilisé pour déterminer les indicateurs de SYNCMGR_HANDLER_CAPABILITIES valides. Comparez à la valeur récupérée par ISyncMgrHandler ::GetCapabilities pour vérifier les résultats valides.

Remarques

Le Centre de synchronisation interroge le gestionnaire pour ses fonctionnalités via ISyncMgrHandler ::GetCapabilities chaque fois que la méthode ISyncMgrControl ::UpdateHandler ou ISyncMgrControl ::UpdateHandlerCollection est appelée.

Configuration requise

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