ISyncMgrHandlerInfo ::IsConnected, méthode (syncmgr.h)

Obtient une valeur qui indique si le gestionnaire ( généralement un type d’appareil externe) est connecté.

Syntaxe

HRESULT IsConnected();

Valeur retournée

Type : HRESULT

Retourne S_OK si le gestionnaire est connecté ; sinon, S_FALSE. Une erreur retournée par cette méthode est interprétée comme S_OK.

Remarques

Si un gestionnaire est déconnecté, ni aucun de ses éléments ne sera synchronisé par le Centre de synchronisation. En outre, la plupart des actions possibles disponibles pour un gestionnaire, telles que La synchronisation, sont supprimées ou désactivées dans l’interface utilisateur du dossier Centre de synchronisation.

Cette valeur est disponible dans l’interface utilisateur du dossier en tant que propriété System.Sync.Connected (PKEY_Sync_Connected).

Le Centre de synchronisation appelle cette méthode chaque fois que la méthode UpdateHandler est appelée.

Examples

L’exemple suivant montre une implémentation de cette méthode qui appelle une fonction de classe privée pour récupérer l’état connecté.

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

Spécifications