RemoteDesktopConnectionInfo Klasse

Referenz

Definition

Namespace:: Windows.System.RemoteDesktop.Provider

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt eine Remotedesktopverbindung auf dem lokalen Desktop dar.

Wichtig

Die RemoteDesktopConnectionInfo-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Um weitere Informationen zu erhalten oder ein Entsperrtoken anzufordern, verwenden Sie das ANFORDERUNGSFORMULAR für LAF-Zugriffstoken.

public ref class RemoteDesktopConnectionInfo sealed

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

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

Public NotInheritable Class RemoteDesktopConnectionInfo

Vererbung: Object Platform::Object IInspectable RemoteDesktopConnectionInfo

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 Insider Preview (eingeführt in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v15.0)

Hinweise

Rufen Sie eine instance dieser Klasse ab, indem Sie GetForLaunchUri aufrufen.

Für die Remotedesktopverbindungen mit CloudPCs, die über die Taskansicht gestartet werden, können Benutzer in der Einstellungs-App auf der Registerkarte CloudPC Datenschutz und Sicherheit > konfigurieren, welche Umleitungen sie zulassen. Anwendungen, die diese API verwenden, möchten möglicherweise die folgenden Registrierungsschlüssel lesen, um die vom Benutzer in der Anwendung Einstellungen festgelegte Cloud-PC-Konfiguration zu berücksichtigen:

Funktion	Registrierungsschlüssel
Zwischenablage	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowClipboardRedirection
Drucker	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowPrinterRedirection
Lokale Festplatte	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowLocalHardDriveRedirection
Mikrofon	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowMicrophoneRedirection
Standort	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowLocationRedirection
Kamera	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowCameraRedirection
Smartcard	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowSmartCardRedirection
USB-Anschlüsse	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowUSBPortsRedirection
COM-Ports	HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowCOMPortsRedirection

Der Wert für jeden Schlüssel ist ein REG_DWORD und wird mit der folgenden Semantik interpretiert:

Off-Wert: 0
Für Wert: 1
Kein Wert (Standardwert): 1

Methoden

GetForLaunchUri(Uri, WindowId)	Ruft eine RemoteDesktopConnectionInfo ab, die einer Remotedesktopverbindung zugeordnet ist, und registriert ein Fenster mit dem Betriebssystem, um den Remotedesktop darzustellen.
PerformLocalActionFromRemote(RemoteDesktopLocalAction)	Stellt eine Remotedesktopverbindung auf dem lokalen Desktop dar. Wichtig Die RemoteDesktopConnectionInfo-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Um weitere Informationen zu erhalten oder ein Entsperrtoken anzufordern, verwenden Sie das ANFORDERUNGSFORMULAR für LAF-Zugriffstoken.
SetConnectionStatus(RemoteDesktopConnectionStatus)	Legt die Verbindung status für die Remotedesktopverbindung fest, die der RemoteDesktopConnectionInfo zugeordnet ist.
SwitchToLocalSession()	Benachrichtigt das Betriebssystem, dass der Benutzer aufgefordert hat, zur lokalen Sitzung zu wechseln.

Gilt für:

Freigeben über