ISyncMgrHandler::Activate, méthode (syncmgr.h)
Demande que le gestionnaire soit activé ou désactivé. Un gestionnaire actif peut être synchronisé ; un gestionnaire inactif ne peut pas.
Syntaxe
HRESULT Activate(
[in] BOOL fActivate
);
Paramètres
[in] fActivate
Type : BOOL
TRUE à 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 actif apparaît dans le dossier Centre de synchronisation et peut être synchronisé. Un gestionnaire inactif apparaît dans le dossier Installation de synchronisation et doit être activé (ce qui le déplace vers le dossier Centre de synchronisation) avant de pouvoir être synchronisé.
L’état d’activation ne doit pas être confondu avec l’état activé. Un gestionnaire actif peut être désactivé. Cela signifie qu’il est toujours affiché dans le dossier Centre de synchronisation, mais qu’il ne peut pas être synchronisé.
Le Centre de synchronisation appelle cette méthode dans les deux instances suivantes.
- Lorsque l’utilisateur sélectionne le gestionnaire dans le dossier Installation de synchronisation et lance sa tâche d’installation . Si le gestionnaire prend en charge l’objet SYNCMGR_OBJECTID_QueryBeforeActivate , cette méthode n’est appelée que si l’opération d’interface utilisateur, qui consiste en une boîte de dialogue demandant à l’utilisateur de confirmer s’il souhaite activer le gestionnaire, a réussi.
- Lorsque l’utilisateur sélectionne le gestionnaire dans le dossier centre de synchronisation et lance sa tâche De suppression , mais uniquement si le gestionnaire n’a pas défini l’indicateur SYNCMGR_HPM_PREVENT_DEACTIVATE . Si le gestionnaire prend en charge l’objet SYNCMGR_OBJECTID_QueryBeforeDeactivate , cette méthode est appelée uniquement si l’opération d’interface utilisateur a réussi.
L’état d’activation d’un gestionnaire individuel est disponible en appelant IsActive.
Si le gestionnaire n’a pas besoin d’effectuer d’actions lorsqu’il est activé, il peut retourner S_OK ou E_NOTIMPL comme indiqué dans l’exemple ci-dessous.
Exemples
L’exemple suivant montre une implémentation simple de cette méthode.
STDMETHODIMP CMyDeviceHandler::Activate(__in BOOL fActivate)
{
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 |