RemoteSystemSessionWatcher Classe

Définition

Espace de noms:

Windows.System.RemoteSystems

Surveille l’activité liée à la découverte de sessions à distance et déclenche les événements appropriés.

public ref class RemoteSystemSessionWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemSessionWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemSessionWatcher

Public NotInheritable Class RemoteSystemSessionWatcher

Héritage

Object Platform::Object IInspectable RemoteSystemSessionWatcher

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Creators Update (introduit dans 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v4.0)
Fonctionnalités de l’application	remoteSystem

Exemples

Consultez l’exemple de code ci-dessous pour connaître le processus de découverte d’une session distante.

// Discover an existing shared experience.
public void DiscoverExistingSessions() {

    // create a watcher for remote system sessions
    RemoteSystemSessionWatcher sessionWatcher = RemoteSystemSession.CreateWatcher();

    // register a handler for the "added" event
    sessionWatcher.Added += async (sender, args) => {

        // get a reference to the info about the discovered session
        RemoteSystemSessionInfo sessionInfo = args.RemoteSystemSessionInfo;

        // update the UI with the sessionInfo.DisplayName and 
        // sessionInfo.ControllerDisplayName strings. Save a reference to 
        // this RemoteSystemSessionInfo, to use when the user selects
        // this session from the UI

        //...
    };

    // Begin watching
    sessionWatcher.Start();
}

Remarques

Cette classe est instanciée lorsque la méthode RemoteSystemSession.CreateWatcher est appelée.

Important

Vous devez confirmer l’accès à la plateforme système distante avec un appel à RemoteSystem.RequestAccessAsync avant d’instancier cette classe.

Important

Les conditions suivantes doivent être remplies pour que la découverte de session à distance fonctionne comme prévu :

1. Bluetooth doit être activé pour les appareils client et hôte. La découverte de session peut fonctionner via la découverte LAN, mais elle n’est pas garantie (elle dépend de la configuration réseau).
2. Dans l’application Paramètres sur l’appareil hôte, le paramètre Partager entre les appareils sous Système -> Expériences partagées doit être défini sur « Tout le monde à proximité ».
3. Les applications clientes et hôtes doivent avoir le même PackageFamilyName.

Propriétés

Status

Obtient la status opérationnelle de cet observateur de session à distance.

Méthodes

Start()	Commence à regarder les sessions à distance détectables. Le processus de découverte s’exécute jusqu’à ce que la méthode Stop soit appelée. Un objet RemoteSystemSessionWatcher peut avoir sa méthode Start appelée à nouveau ultérieurement.
Stop()	Arrête l’observation des sessions à distance détectables.

Événements

Added	Déclenché lorsqu’une nouvelle session à distance a été découverte par RemoteSystemSessionWatcher.
Removed	Déclenché lorsqu’une session distante précédemment découverte a disparu.
Updated	Déclenché lorsqu’une session à distance précédemment découverte a une partie de ses informations mises à jour.