RemoteSystem Klasse

Definition

Namespace:

Windows.System.RemoteSystems

Diese Klasse verwaltet die Attribute eines ermittelten Remotesystems (Geräts) und bietet die Funktionen zum Ermitteln von Remotesystemen im Rahmen von Project Rome.

public ref class RemoteSystem sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RemoteSystem final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystem

Public NotInheritable Class RemoteSystem

Vererbung

Object Platform::Object IInspectable RemoteSystem

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 ein Remotesystem (Gerät) erkannt, aktualisiert oder ausgeblendet wird (auf die instance wird als Eigenschaft der Klasse RemoteSystemAddedEventArgs, RemoteSystemUpdatedEventArgs oder RemoteSystemRemovedEventArgs verwiesen).

Die Eigenschaften der RemoteSystem-Klasse werden verwendet, um die Vorgänge zu bestimmen, die auf einem bestimmten Remotesystem ausgeführt werden können.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1703	15063	GetCapabilitySupportedAsync
1703	15063	IsAuthorizationKindEnabled
1703	15063	IsAvailableBySpatialProximity
1709	16299	ManufacturerDisplayName
1709	16299	ModelDisplayName
1803	17134	Plattform
1809	17763	Apps
1903	18362	CreateWatcherForUser(User)
1903	18362	CreateWatcherForUser(User,IEnumerable<IRemoteSystemFilter>)
1903	18362	User

Eigenschaften

Apps	Eine Liste der Anwendungen auf diesem Remotesystem, die bei der Plattform für verbundene Geräte registriert wurden.
DisplayName	Ruft den Computernamen des angegebenen Remotesystems ab.
Id	Ruft den eindeutigen Zeichenfolgenbezeichner für das angegebene Remotesystem ab.
IsAvailableByProximity	Überprüft, ob das angegebene Remotesystem über eine proximale Verbindung (z. B. eine Bluetooth- oder lokale Netzwerkverbindung) im Gegensatz zur Cloudverbindung verfügbar ist.
IsAvailableBySpatialProximity	Überprüft, ob das angegebene Remotesystem über eine räumlich proximale Verbindung verfügbar ist.
Kind	Ruft eine Zeichenfolgendarstellung des Gerätetyps des angegebenen Remotesystems ab.
ManufacturerDisplayName	Ruft den Herstellernamen des angegebenen Remotesystems ab.
ModelDisplayName	Ruft den Modellnamen des angegebenen Remotesystems ab.
Platform	Ruft einen Wert ab, der die Betriebssystemplattform beschreibt, die auf diesem Remotesystem ausgeführt wird.
Status	Ruft die status der Verfügbarkeit dieses Remotesystems ab.
User	Ruft die User-Eigenschaft ab.

Methoden

CreateWatcher()	Gibt ein RemoteSystemWatcher-Objekt ohne Filter zurück.
CreateWatcher(IIterable<IRemoteSystemFilter>)	Gibt ein RemoteSystemWatcher-Objekt zurück, das die angezeigten Remotesysteme filtert. Der Filterparameter bestimmt, welche Remotesysteme angezeigt werden.
CreateWatcherForUser(User)	Gibt ein RemoteSystemWatcher-Objekt zurück, das im Kontext des angegebenen Benutzers ausgeführt wird. Der Parameter user gibt den Benutzer an, für den Geräte ermittelt werden sollen.
CreateWatcherForUser(User, IIterable<IRemoteSystemFilter>)	Gibt ein RemoteSystemWatcher-Objekt zurück, das im Kontext eines bestimmten Benutzers arbeitet und die Remotesysteme filtert, die angezeigt werden können. Der Parameter user gibt den Benutzer an, für den Remotesysteme ermittelt werden sollen. Der Filterparameter bestimmt, welche Remotesysteme angezeigt werden.
FindByHostNameAsync(HostName)	Versucht, ein einzelnes Remotesystem zu ermitteln, das durch den HostName-Parameter angegeben wird.
GetCapabilitySupportedAsync(String)	Gibt an, ob das RemoteSystem die angegebene Remotesystemfunktion verwenden kann.
IsAuthorizationKindEnabled(RemoteSystemAuthorizationKind)	Überprüft, ob das Clientgerät autorisiert ist, die Geräte anderer Benutzer oder nur geräte mit demselben Benutzer zu ermitteln.
RequestAccessAsync()	Ruft den status des Zugriffs der aufrufenden App auf das Feature Remotesysteme ab. Diese Methode sollte immer aufgerufen werden, bevor eine App versucht, Remotesysteme zu ermitteln oder anderweitig mit ihnen zu interagieren.

Weitere Informationen

• Verbundene Apps und Geräte (Projekt „Rome”)
• Beispiel für Remotesysteme