Share via


ISyncMgrSyncItem ::Enable, méthode (syncmgr.h)

Active ou désactive l’élément de synchronisation.

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

Le Centre de synchronisation appelle cette méthode dans les scénarios suivants.

  • Lorsque l’utilisateur sélectionne l’élément dans le dossier du gestionnaire et lance sa tâche Activer , mais uniquement si l’élément n’a pas défini l’indicateur SYNCMGR_IPM_PREVENT_ENABLE . 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 l’élément dans le dossier du gestionnaire et lance sa tâche Désactiver , mais uniquement si l’élément n’a pas défini l’indicateur SYNCMGR_IPM_PREVENT_DISABLE . 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.
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 CMyDeviceSyncItem::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

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]
Plateforme cible Windows
En-tête syncmgr.h