RemoteSystemWatcher Klasse

Definition

Namespace:

Windows.System.RemoteSystems

Überwacht Aktivitäten im Zusammenhang mit der Ermittlung von Remotesystemen und löst die entsprechenden Ereignisse aus.

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

Vererbung

Object Platform::Object IInspectable RemoteSystemWatcher

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
App-Funktionen	remoteSystem

Hinweise

Diese Klasse wird instanziiert, wenn die statische Methode CreateWatcher aufgerufen wird. Objekte dieser Klasse beginnen mit der Überwachung der Aktivität, wenn die Start-Methode aufgerufen wird, und beenden, wenn Stop aufgerufen wird, wenn die App beendet oder vom System angehalten wird oder wenn ein Fehler auftritt.

Wichtig

Sie müssen den Zugriff auf die Remotesystemplattform mit einem Aufruf von RemoteSystem.RequestAccessAsync bestätigen, bevor Sie diese Klasse instanziieren.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1803	17134	EnumerationCompleted
1803	17134	ErrorOccurred
1903	18362	Benutzer

Eigenschaften

User	Stellt den Benutzer dar, für den remoteSystemWatcher Geräte anzeigen möchten.

Methoden

Start()	Beginnt mit der Suche nach auffindbaren Remotesystemen. Der Ermittlungsprozess wird so lange ausgeführt, bis die Stop-Methode aufgerufen wird oder ein Fehler auftritt. Für ein RemoteSystemWatcher-Objekt kann die Start-Methode zu einem späteren Zeitpunkt erneut aufgerufen werden.
Stop()	Stoppt die Überwachung nach auffindbaren Remotesystemen.

Ereignisse

EnumerationCompleted	Dieses Ereignis wird ausgelöst, wenn der anfängliche Remotesystemermittlungsprozess abgeschlossen ist.
ErrorOccurred	Dieses Ereignis wird ausgelöst, wenn während der Ermittlung ein Fehler auftritt. Der Ermittlungsprozess wird nach Möglichkeit fortgesetzt. Wenn der Fehler beispielsweise mit dem Wert RemoteSystemWatcherError.InternetNotAvailable auftritt (siehe RemoteSystemWatcherError), wird die proximale Ermittlung fortgesetzt, da der Fehler nur für die Cloudermittlung gilt (siehe RemoteSystemDiscoveryType).
RemoteSystemAdded	Das Ereignis, das ausgelöst wird, wenn ein neues Remotesystem (Gerät) erkannt wird.
RemoteSystemRemoved	Das Ereignis, das ausgelöst wird, wenn ein zuvor ermitteltes Remotesystem (Gerät) nicht mehr sichtbar ist.
RemoteSystemUpdated	Wird ausgelöst, wenn ein Remotesystem (Gerät), das zuvor in dieser Ermittlungssitzung erkannt wurde, sich von der verbindung mit der Cloud oder umgekehrt ändert. Sie wird auch ausgelöst, wenn ein Remotesystem eine seiner überwachten Eigenschaften ändert (siehe die Eigenschaften der RemoteSystem-Klasse ).

Weitere Informationen

• Verbundene Apps und Geräte (Projekt „Rome”)