ISyncMgrHandler::Activate, méthode (syncmgr.h)

Article
08/26/2023

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.

Si l’indicateur SYNCMGR_HPM_PREVENT_ACTIVATE est défini dans la valeur récupérée par ISyncMgrHandler::GetCapabilities, un appel à cette méthode demandant l’activation du gestionnaire échoue.

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

Voir aussi

ISyncMgrHandler

ISyncMgrHandler::GetObject

ISyncMgrUIOperation::Run

Partager via