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

Article
03/02/2024

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

Partager via