RemoteSystemSessionInfo Clase

Definición

Espacio de nombres:

Windows.System.RemoteSystems

Contiene información de identificación sobre una sesión 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

Herencia

Object Platform::Object IInspectable RemoteSystemSessionInfo

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)
Características de aplicaciones	remoteSystem

Ejemplos

Consulte el ejemplo de código siguiente para obtener el proceso completo de detección de una sesión remota (incluida la obtención de una referencia a una instancia de 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();
}

Una vez que se ha adquirido una referencia remoteSystemSessionInfo , se puede usar para emitir una solicitud de unión. Consulte el ejemplo de código siguiente para ver el proceso de unión a una sesión 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
    }
}

Comentarios

Una sesión que se ha unido está representada por un objeto RemoteSystemSession . Una sesión conocida sobre pero que no se ha unido está representada por un objeto RemoteSystemSessionInfo .

Propiedades

ControllerDisplayName	Obtiene el nombre de la máquina del dispositivo que es el controlador de la sesión remota.
DisplayName	Obtiene el nombre de acceso público para la sesión remota, dada por el controlador de la sesión.

Métodos

JoinAsync()

Emite una solicitud desde el dispositivo que realiza la llamada para unirse a la sesión remota determinada.