RemoteSystemSessionInfo Classe

Definição

Namespace:

Windows.System.RemoteSystems

Contém informações de identificação sobre uma sessão remota.

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

Herança

Object Platform::Object IInspectable RemoteSystemSessionInfo

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v4.0)
Funcionalidades do aplicativo	remoteSystem

Exemplos

Consulte o exemplo de código abaixo para obter o processo completo de descoberta de uma sessão remota (incluindo a obtenção de uma referência a uma instância 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();
}

Depois que uma referência RemoteSystemSessionInfo for adquirida, ela poderá ser usada para emitir uma solicitação de junção. Consulte o exemplo de código abaixo para obter o processo de ingressar em uma sessão remota.

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
    }
}

Comentários

Uma sessão que foi unida é representada por um objeto RemoteSystemSession . Uma sessão que é conhecida, mas não foi unida, é representada por um objeto RemoteSystemSessionInfo .

Propriedades

ControllerDisplayName	Obtém o nome do computador do dispositivo que é o controlador da sessão remota.
DisplayName	Obtém o nome voltado para o público para a sessão remota, fornecido pelo controlador da sessão.

Métodos

JoinAsync()

Emite uma solicitação do dispositivo de chamada para ingressar na sessão remota fornecida.