RemoteSystem 类

定义

命名空间:

Windows.System.RemoteSystems

此类管理已发现的远程系统 (设备) 的属性，并提供在 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

继承

Object Platform::Object IInspectable RemoteSystem

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
应用功能	remoteSystem

注解

每当发现、更新或消失远程系统 (设备) 时，都会实例化此类， (该实例作为 RemoteSystemAddedEventArgs、 RemoteSystemUpdatedEventArgs 或 RemoteSystemRemovedEventArgs 类) 的属性引用。

RemoteSystem 类的属性用于确定可以在给定远程系统上执行的操作。

版本历史记录

Windows 版本	SDK 版本	增值
1703	15063	GetCapabilitySupportedAsync
1703	15063	IsAuthorizationKindEnabled
1703	15063	IsAvailableBySpatialProximity
1709	16299	ManufacturerDisplayName
1709	16299	ModelDisplayName
1803	17134	平台
1809	17763	“应用”
1903	18362	CreateWatcherForUser (User)
1903	18362	CreateWatcherForUser (User，IEnumerable<IRemoteSystemFilter>)
1903	18362	用户

属性

Apps	此远程系统上已注册到连接设备平台的应用程序列表。
DisplayName	获取给定远程系统的计算机名称。
Id	获取给定远程系统的唯一字符串标识符。
IsAvailableByProximity	检查给定的远程系统是否通过近端连接 (（例如蓝牙或本地网络连接）) （而不是云连接）提供。
IsAvailableBySpatialProximity	通过空间近端连接检查给定的远程系统是否可用。
Kind	获取给定远程系统的设备类型的字符串表示形式。
ManufacturerDisplayName	获取给定远程系统的制造商名称。
ModelDisplayName	获取给定远程系统的模型名称。
Platform	获取一个值，该值描述此远程系统正在运行的 OS 平台。
Status	获取此远程系统的可用性的状态。
User	获取 User 属性。

方法

CreateWatcher()	返回不带筛选器的 RemoteSystemWatcher 对象。
CreateWatcher(IIterable<IRemoteSystemFilter>)	返回一个 RemoteSystemWatcher 对象，该对象筛选它可以看到的远程系统。 filters 参数确定将看到哪些远程系统。
CreateWatcherForUser(User)	返回在指定用户的上下文中操作的 RemoteSystemWatcher 对象。 user 参数指示要为其发现设备的用户。
CreateWatcherForUser(User, IIterable<IRemoteSystemFilter>)	返回一个 RemoteSystemWatcher 对象，该对象在给定用户的上下文中运行，并筛选它可以看到的远程系统。 user 参数指示要为其发现远程系统的用户。 filters 参数确定将看到哪些远程系统。
FindByHostNameAsync(HostName)	尝试发现 由 HostName 参数指定的单个远程系统。
GetCapabilitySupportedAsync(String)	报告 RemoteSystem 是否能够使用给定的远程系统功能。
IsAuthorizationKindEnabled(RemoteSystemAuthorizationKind)	检查客户端设备是否有权发现其他用户的设备或仅发现同一用户设备。
RequestAccessAsync()	获取调用应用对远程系统功能的访问权限的状态。 在应用尝试发现远程系统或以其他方式与远程系统交互之前，应始终调用此方法。

另请参阅

• 连接的应用和设备（项目 Rome）
• 远程系统示例