RemoteSystem Class

Definition

This class manages the attributes of a discovered remote system (device) and provides the capabilities to discover remote systems as part of Project Rome.

public ref class RemoteSystem sealed
class RemoteSystem sealed
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics), 196608, "Windows.Foundation.UniversalApiContract")]
public sealed class RemoteSystem
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics), 196608, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics2), 262144, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystem
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics), 196608, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics2), 262144, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Static(typeof(Windows.System.RemoteSystems.IRemoteSystemStatics3), 524288, "Windows.Foundation.UniversalApiContract")]
public sealed class RemoteSystem
Public NotInheritable Class RemoteSystem
Inheritance
RemoteSystem
Attributes

Windows 10 requirements

Device family
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v3.0)
App capabilities
remoteSystem

Remarks

This class is instantiated whenever a remote system (device) is discovered, is updated, or disappears (the instance is referenced as a property of the RemoteSystemAddedEventArgs, RemoteSystemUpdatedEventArgs, or RemoteSystemRemovedEventArgs class).

The properties of the RemoteSystem class are used to determine the operations that can be done on a given remote system.

Version history

Windows version SDK version Value added
1703 15063 GetCapabilitySupportedAsync
1703 15063 IsAuthorizationKindEnabled
1703 15063 IsAvailableBySpatialProximity
1709 16299 ManufacturerDisplayName
1709 16299 ModelDisplayName
1803 17134 Platform
1809 17763 Apps
1903 18362 CreateWatcherForUser(User)
1903 18362 CreateWatcherForUser(User,IEnumerable)
1903 18362 User

Properties

Apps

A list of the applications on this remote system that have registered with the Connected Devices Platform.

DisplayName

Gets the machine name of the given remote system.

Id

Gets the unique string identifier for the given remote system.

IsAvailableByProximity

Checks whether the given remote system is available through proximal connection (such as a Bluetooth or local network connection) as opposed to cloud connection.

IsAvailableBySpatialProximity

Checks whether the given remote system is available through spatially proximal connection.

Kind

Gets a String representation of the device type of the given remote system (desktop, Xbox, ...).

ManufacturerDisplayName

Gets the manufacturer name of the given remote system.

ModelDisplayName

Gets the model name of the given remote system.

Platform

Gets a value describing the OS platform that this remote system is running.

Status

Gets the status of this remote system's availability.

User

Gets the User property.

Methods

CreateWatcher()

Returns a RemoteSystemWatcher object with no filters.

CreateWatcher(IEnumerable<IRemoteSystemFilter>)

Returns a RemoteSystemWatcher object that filters the remote systems it can see. The filters parameter determines which remote systems will be seen.

CreateWatcherForUser(User)

Returns a RemoteSystemWatcher object that operates in the context of the specified User. The user parameter indicates the User to discover devices for.

CreateWatcherForUser(User, IEnumerable<IRemoteSystemFilter>)

Returns a RemoteSystemWatcher object that operates in the context of a given User and filters the remote systems it can see. The user parameter indicates the User to discover remote systems for. The filters parameter determines which remote systems will be seen.

FindByHostNameAsync(HostName)

Attempts to discover a single remote system specified by the HostName parameter.

GetCapabilitySupportedAsync(String)

Reports whether the RemoteSystem is capable of the given Remote System feature.

IsAuthorizationKindEnabled(RemoteSystemAuthorizationKind)

Checks whether the client device is authorized to discover other users' devices or just same-user devices.

RequestAccessAsync()

Gets the status of the calling app's access to the Remote Systems feature. This method should always be called before an app attempts to discover or otherwise interact with remote systems.

Applies to

See also