RemoteSystem Class

Definition

Namespace:

Windows.System.RemoteSystems

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RemoteSystem final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystem

Public NotInheritable Class RemoteSystem

Inheritance

Object Platform::Object IInspectable RemoteSystem

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 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<IRemoteSystemFilter>)
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.
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(IIterable<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, IIterable<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.
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.
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.

See also

• Connected apps and devices (Project Rome)
• Remote systems sample