RemoteSystemSessionInfo Classe

Définition

Espace de noms:

Windows.System.RemoteSystems

Contient des informations d’identification sur une session à distance.

public ref class RemoteSystemSessionInfo sealed

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

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

Public NotInheritable Class RemoteSystemSessionInfo

Héritage

Object Platform::Object IInspectable RemoteSystemSessionInfo

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 complet de découverte d’une session à distance (y compris l’obtention d’une référence à un instance RemoteSystemSessionInfo).

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

Une fois qu’une référence RemoteSystemSessionInfo a été acquise, elle peut être utilisée pour émettre une demande de jointure. Consultez l’exemple de code ci-dessous pour connaître le processus de participation à une session à distance.

public async void JoinExistingSession() {

    // request to join. sessionInfo has already been selected by user.
    RemoteSystemSessionJoinResult joinResult = await sessionInfo.JoinAsync();

    // process the result
    if (joinResult.Status == RemoteSystemSessionJoinStatus.Success) {

        // if the join was successful, acquire a reference to the session
        currentSession = joinResult.Session;

        // optionally handle the disconnected event
        currentSession.Disconnected += async (sender, args) => {
            // update the UI, using args.Reason
        };

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

    } else {
        // join request failed. optionally update UI
    }
}

Remarques

Une session qui a été jointe est représentée par un objet RemoteSystemSession . Une session connue mais qui n’a pas été jointe est représentée par un objet RemoteSystemSessionInfo .

Propriétés

ControllerDisplayName	Obtient le nom de l’ordinateur de l’appareil qui est le contrôleur de la session distante.
DisplayName	Obtient le nom public de la session à distance, donné par le contrôleur de la session.

Méthodes

JoinAsync()

Émet une demande de l’appareil appelant pour rejoindre la session à distance donnée.