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

Article
08/26/2023

Génère une valeur qui indique si l’élément (généralement un type d’appareil externe) est connecté.

Syntaxe

HRESULT IsConnected();

Valeur de retour

Type : HRESULT

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

Remarques

Si un élément est déconnecté, il n’est pas synchronisé par le Centre de synchronisation. En outre, un grand nombre des actions possibles disponibles pour un élément, comme Synchroniser, sont supprimées ou désactivées dans l’interface utilisateur.

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 CMyDeviceSyncItem::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