ISyncMgrHandler::Enable, méthode (syncmgr.h)
Demande qu’un gestionnaire actif soit activé ou désactivé. Un gestionnaire activé peut être synchronisé et un gestionnaire désactivé ne peut pas.
Syntaxe
HRESULT Enable(
[in] BOOL fEnable
);
Paramètres
[in] fEnable
Type : BOOL
TRUE pour activer ; FALSE à désactiver.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Un gestionnaire doit définir les indicateurs SYNCMGR_HCM_CAN_ENABLE et SYNCMGR_HCM_CAN_DISABLE pour que les entrées Activer et Désactiver s’affichent dans le menu contextuel du gestionnaire lorsque le gestionnaire s’affiche dans le dossier Centre de synchronisation. Le choix d’activer un gestionnaire signifie qu’il peut être synchronisé ; Si vous choisissez de désactiver un gestionnaire, cela signifie qu’il ne peut pas le faire.
Le Centre de synchronisation appelle cette méthode dans les deux instances suivantes.
- Lorsque l’utilisateur sélectionne le gestionnaire dans le dossier Centre de synchronisation et lance sa tâche Activer . Si le gestionnaire prend en charge l’objet SYNCMGR_OBJECTID_QueryBeforeEnable , cette méthode est appelée uniquement si l’opération d’interface utilisateur a réussi.
- Lorsque l’utilisateur sélectionne le gestionnaire dans le dossier centre de synchronisation et lance sa tâche Désactiver . Si le gestionnaire prend en charge l’objet SYNCMGR_OBJECTID_QueryBeforeDisable , cette méthode est appelée uniquement si l’opération d’interface utilisateur a réussi.
Exemples
L’exemple suivant montre une implémentation simple de cette méthode.
STDMETHODIMP CMyDeviceHandler::Enable(__in BOOL fEnable)
{
return E_NOTIMPL;
}
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 |