Compartir a través de

Método ISyncMgrHandlerInfo::IsConnected (syncmgr.h)

  • Artículo

Obtiene un valor que indica si el controlador (normalmente algún tipo de dispositivo externo) está conectado.

Sintaxis

HRESULT IsConnected();

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si el controlador está conectado; de lo contrario, S_FALSE. Un error devuelto por este método se interpretará como S_OK.

Comentarios

Si un controlador está desconectado, el Centro de sincronización no sincronizará ni ninguno de sus elementos. Además, muchas de las posibles acciones disponibles para un controlador, como Sync, se quitan o deshabilitan en la interfaz de usuario de la carpeta del Centro de sincronización.

Este valor está disponible en la interfaz de usuario de la carpeta como la propiedad System.Sync.Connected (PKEY_Sync_Connected).

El Centro de sincronización llama a este método cada vez que se llama al método UpdateHandler .

Ejemplos

En el ejemplo siguiente se muestra una implementación de este método que llama a una función de clase privada para recuperar el estado conectado.

STDMETHODIMP CMyDeviceHandler::IsConnected()
{
    return (_IsConnected() ? S_OK : S_FALSE);
}

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