Partager via


RemoteSystemWatcher Classe

Définition

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
Object Platform::Object IInspectable RemoteSystemWatcher
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 ).

S’applique à

Voir aussi