RemoteSystemWatcher Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surveille l’activité liée à la découverte de systèmes distants et déclenche les événements appropriés.
public ref class RemoteSystemWatcher sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemWatcher final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemWatcher
Public NotInheritable Class RemoteSystemWatcher
- Héritage
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v3.0)
|
Fonctionnalités de l’application |
remoteSystem
|
Remarques
Cette classe est instanciée lorsque la méthode statique CreateWatcher est appelée. Les objets de cette classe commencent à surveiller l’activité lorsque la méthode Start est appelée et s’arrêtent quand Stop est appelé, lorsque l’application se ferme ou est suspendue par le système, ou si une erreur se produit.
Important
Vous devez confirmer l’accès à la plateforme système distante avec un appel à RemoteSystem.RequestAccessAsync avant d’instancier cette classe.
Historique des versions
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1803 | 17134 | ÉnumérationCompleted |
1803 | 17134 | ErrorOccurred |
1903 | 18362 | Utilisateur |
Propriétés
User |
Représente l’utilisateur pour lequel RemoteSystemWatcher a l’intention de voir les appareils. |
Méthodes
Start() |
Commence à surveiller les systèmes distants détectables. Le processus de découverte s’exécute jusqu’à ce que la méthode Stop soit appelée ou qu’une erreur se produise. Sa méthode Start peut être appelée ultérieurement pour un objet RemoteSystemWatcher. |
Stop() |
Cesse de surveiller les systèmes distants détectables. |
Événements
EnumerationCompleted |
Cet événement est déclenché lorsque le processus initial de découverte du système distant est terminé. |
ErrorOccurred |
Cet événement est déclenché lorsqu’une erreur se produit lors de la découverte. Si possible, le processus de découverte se poursuit. Par exemple, si l’erreur se produit avec une valeur RemoteSystemWatcherError.InternetNotAvailable (voir RemoteSystemWatcherError), la découverte proximale continue, car l’erreur s’applique uniquement à la découverte cloud (voir RemoteSystemDiscoveryType). |
RemoteSystemAdded |
Événement déclenché lorsqu’un nouveau système distant (appareil) est découvert. |
RemoteSystemRemoved |
Événement déclenché lorsqu’un système distant (appareil) précédemment découvert n’est plus visible. |
RemoteSystemUpdated |
Déclenché lorsqu’un système distant (appareil) qui a été précédemment découvert dans cette session de découverte passe d’une connexion immédiate à une connexion au cloud, ou à l’inverse. Elle est également déclenchée lorsqu’un système distant modifie l’une de ses propriétés surveillées (voir les propriétés de la classe RemoteSystem ). |