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 (使用者)
1903	18362	CreateWatcherForUser (User，IEnumerable < IRemoteSystemFilter >)
1903	18362	使用者

屬性

Apps	此遠端系統上已向連線裝置平臺註冊的應用程式清單。
DisplayName	取得指定遠端系統的機器名稱。
Id	取得指定遠端系統的唯一字串識別碼。
IsAvailableByProximity	檢查指定的遠端系統是否可透過近端連線 (，例如藍牙或區域網路連線) ，而不是雲端連線。
IsAvailableBySpatialProximity	檢查指定的遠端系統是否可透過空間近端連線取得。
Kind	取得指定遠端系統的裝置類型的 String 表示。
ManufacturerDisplayName	取得指定遠端系統的製造商名稱。
ModelDisplayName	取得指定遠端系統的模型名稱。
Platform	取得值，這個值描述這個遠端系統正在執行的 OS 平臺。
Status	取得這個遠端系統可用性的狀態。
User	取得 User 屬性。

方法

CreateWatcher()	會傳回沒有篩選準則的 RemoteSystemWatcher 物件。
CreateWatcher(IIterable<IRemoteSystemFilter>)	會傳回 RemoteSystemWatcher 物件，以篩選其可以看到的遠端系統。 篩選參數會決定會看到哪些遠端系統。
CreateWatcherForUser(User)	會傳回 RemoteSystemWatcher 物件，該物件會在指定之 User 的內容中運作。 使用者參數指出要探索裝置的使用者。
CreateWatcherForUser(User, IIterable<IRemoteSystemFilter>)	會傳回 RemoteSystemWatcher 物件，該物件會在指定使用者的內容中運作，並篩選它可以看到的遠端系統。 user參數指出要探索遠端系統的使用者。 篩選參數會決定會看到哪些遠端系統。
FindByHostNameAsync(HostName)	嘗試探索 HostName 參數所指定的單一遠端系統。
GetCapabilitySupportedAsync(String)	報告 RemoteSystem 是否能夠使用指定的遠端系統功能。
IsAuthorizationKindEnabled(RemoteSystemAuthorizationKind)	檢查用戶端裝置是否已獲得授權，以探索其他使用者的裝置，或只是相同的使用者裝置。
RequestAccessAsync()	取得呼叫端應用程式對遠端系統功能存取的狀態。 在應用程式嘗試探索或與遠端系統互動之前，應該一律呼叫此方法。

另請參閱

• 已連線的應用程式與裝置 (Project Rome)
• 遠端系統範例