RemoteSystemWatcher 类

定义

监视与发现远程系统相关的活动,并引发相应的事件。

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
属性

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 类) 的属性时,也会引发此事件。

适用于

另请参阅