通过

RemoteDesktopConnectionInfo 类

  • 参考

定义

命名空间:
Windows.System.RemoteDesktop.Provider
编辑

表示本地桌面上的远程桌面连接。

重要

RemoteDesktopConnectionInfo API 是受限访问功能的一部分 (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请使用 LAF 访问令牌请求表单。

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
继承
Object Platform::Object IInspectable RemoteDesktopConnectionInfo
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列
Windows 11 Insider Preview (在 10.0.23504.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v15.0 中引入)

注解

通过调用 GetForLaunchUri 获取此类的实例。

对于从“任务”视图启动的与 CloudPC 的远程桌面连接，用户可以在“ 隐私和安全 > ”CloudPC 选项卡下的“设置”应用中配置允许的重定向。使用此 API 的应用程序可能需要读取以下注册表项，以遵循用户在“设置”应用程序中设置的云电脑配置：

功能 注册表项
剪贴板 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowClipboardRedirection
打印机 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowPrinterRedirection
本地硬盘驱动器 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowLocalHardDriveRedirection
麦克风 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowMicrophoneRedirection
位置 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowLocationRedirection
照相机 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowCameraRedirection
智能卡 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowSmartCardRedirection
USB 端口 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowUSBPortsRedirection
COM 端口 HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\CloudPCSetting\AllowCOMPortsRedirection

每个键的值都是一个REG_DWORD，并使用以下语义进行解释：

  • 关闭值：0
  • 值：1
  • 无值 (默认) ：1

方法

GetForLaunchUri(Uri, WindowId)

检索与远程桌面连接关联的 RemoteDesktopConnectionInfo ，并将窗口注册到 OS 以表示远程桌面。
PerformLocalActionFromRemote(RemoteDesktopLocalAction)

表示本地桌面上的远程桌面连接。

重要

RemoteDesktopConnectionInfo API 是受限访问功能的一部分 (请参阅 LimitedAccessFeatures 类) 。 有关详细信息或请求解锁令牌，请使用 LAF 访问令牌请求表单。
SetConnectionStatus(RemoteDesktopConnectionStatus)

设置与 RemoteDesktopConnectionInfo 关联的远程桌面连接的连接状态。
SwitchToLocalSession()

通知 OS 用户已请求切换到本地会话。

适用于