Freigeben über


RemoteSystemWatcher Klasse

Definition

Ü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

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 ).

Gilt für:

Weitere Informationen