RemoteSystemWatcher 類別

定義

命名空間:

Windows.System.RemoteSystems

監看與探索遠端系統相關的活動，並引發適當的事件。

public ref class RemoteSystemWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemWatcher

Public NotInheritable Class RemoteSystemWatcher

繼承

Object Platform::Object IInspectable RemoteSystemWatcher

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)
應用程式功能	remoteSystem

備註

呼叫靜態方法 CreateWatcher 時，就會具現化這個類別。 呼叫 Start 方法並 停止時、 當系統結束或暫停應用程式時，或發生錯誤時，這個類別的物件會開始監看活動。

重要

您必須先使用 呼叫 RemoteSystem.RequestAccessAsync 來確認遠端系統平臺的存取權，才能具現化此類別。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1803	17134	EnumerationCompleted
1803	17134	ErrorOccurred
1903	18362	User

屬性

User	代表 RemoteSystemWatcher 想要查看裝置的使用者。

方法

Start()	開始監看可探索的遠端系統。 探索程式會執行，直到呼叫 Stop 方法或發生錯誤為止。 RemoteSystemWatcher物件可以在稍後再次呼叫其Start方法。
Stop()	停止監看可探索的遠端系統。

事件

EnumerationCompleted	當初始遠端系統探索程式完成時，就會引發此事件。
ErrorOccurred	當探索期間發生錯誤時，就會引發此事件。 可能的話，探索程式將會繼續。 例如，如果錯誤發生于 RemoteSystemWatcherError.InternetNotAvailable (請參閱 RemoteSystemWatcherError) ，則代理程式探索會繼續，因為錯誤僅適用于雲端探索， (請參閱 RemoteSystemDiscoveryType) 。
RemoteSystemAdded	探索到新的遠端系統 (裝置) 時所引發的事件。
RemoteSystemRemoved	當先前探索到的遠端系統 (裝置) 不再顯示時所引發的事件。
RemoteSystemUpdated	當遠端系統 (裝置) 先前在此探索會話中所探索到的裝置，從與雲端連線的 proxy 或反向變更時引發。 當遠端系統變更其中一個受監視的屬性時，也會引發 (查看 RemoteSystem 類別的屬性) 。

另請參閱

• 已連線的應用程式與裝置 (Project Rome)