RemoteSystem Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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)]
class RemoteSystem final
/// [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)]
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.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystem
Public NotInheritable Class RemoteSystem
- Inheritance
- Attributes
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. |