RemoteSystemWatcher 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
监视与发现远程系统相关的活动,并引发相应的事件。
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
- 继承
- 属性
Windows 要求
设备系列 |
Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v3.0 中引入)
|
应用功能 |
remoteSystem
|
注解
调用静态方法 CreateWatcher 时,将实例化此类。 此类的对象在调用 Start 方法时开始监视活动,在调用 Stop 时停止,当应用退出或被系统挂起时,或者如果发生错误,则停止。
重要
在实例化此类之前,必须通过调用 RemoteSystem.RequestAccessAsync 来确认对远程系统平台的访问。
版本历史记录
Windows 版本 | SDK 版本 | 增值 |
---|---|---|
1803 | 17134 | EnumerationCompleted |
1803 | 17134 | ErrorOccurred |
1903 | 18362 | 用户 |
属性
User |
表示 RemoteSystemWatcher 打算查看其设备的用户。 |
方法
Start() |
开始监视可发现的远程系统。 发现进程将一直运行,直到调用 Stop 方法或发生错误。 RemoteSystemWatcher 对象以后可以再次调用其 Start 方法。 |
Stop() |
停止监视可发现的远程系统。 |
事件
EnumerationCompleted |
当初始远程系统发现过程完成时,将引发此事件。 |
ErrorOccurred |
当发现过程中发生错误时,将引发此事件。 如果可能,发现过程将继续。 例如,如果错误发生时值为 RemoteSystemWatcherError.InternetNotAvailable (请参阅 RemoteSystemWatcherError) ,则近端发现将继续,因为错误仅适用于云发现 (请参阅 RemoteSystemDiscoveryType) 。 |
RemoteSystemAdded |
发现新的远程系统 (设备) 时引发的事件。 |
RemoteSystemRemoved |
以前发现的远程系统 (设备) 不再可见时引发的事件。 |
RemoteSystemUpdated |
当远程系统 (以前在此发现会话中发现的设备) 从近端连接到云或反向时引发。 当远程系统更改其监视属性之一 (查看 RemoteSystem 类) 的属性时,也会引发此事件。 |