Compartir a través de


Método ISyncMgrSyncItem::Enable (syncmgr.h)

Habilita o deshabilita el elemento de sincronización.

Sintaxis

HRESULT Enable(
  [in] BOOL fEnable
);

Parámetros

[in] fEnable

Tipo: BOOL

TRUE para habilitar; FALSE para deshabilitar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El Centro de sincronización llama a este método en los escenarios siguientes.

  • Cuando el usuario selecciona el elemento en la carpeta del controlador e inicia su tarea Habilitar , pero solo si el elemento no ha establecido la marca SYNCMGR_IPM_PREVENT_ENABLE . Si el controlador admite el objeto SYNCMGR_OBJECTID_QueryBeforeEnable , solo se llama a este método si la operación de la interfaz de usuario se realizó correctamente.
  • Cuando el usuario selecciona el elemento en la carpeta del controlador e inicia su tarea Deshabilitar , pero solo si el elemento no ha establecido la marca SYNCMGR_IPM_PREVENT_DISABLE . Si el controlador admite el objeto SYNCMGR_OBJECTID_QueryBeforeDisable , solo se llama a este método si la operación de interfaz de usuario se realizó correctamente.
Si el controlador no necesita realizar ninguna acción cuando se activa, puede devolver S_OK o E_NOTIMPL como se muestra en el ejemplo siguiente.

Ejemplos

En el ejemplo siguiente se muestra una implementación sencilla de este método.

STDMETHODIMP CMyDeviceSyncItem::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado syncmgr.h