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

Article
03/04/2024

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

Syntaxe

HRESULT IsConnected();

Valeur de retour

Type : HRESULT

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

Remarques

Si un gestionnaire est déconnecté, ni lui ni aucun de ses éléments ne sera synchronisé par le Centre de synchronisation. En outre, un grand nombre des actions possibles disponibles pour un gestionnaire, telles que Synchroniser, 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.

Exemples

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);
}

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