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를 호출하여 이 클래스의 instance 가져옵니다.

작업 보기에서 시작된 CloudPC에 대한 원격 데스크톱 연결의 경우 사용자는 개인 정보 및 보안 > CloudPC 탭의 설정 앱에서 허용하는 리디렉션을 구성할 수 있습니다. 이 API를 사용하는 애플리케이션은 설정 애플리케이션에서 사용자가 설정한 클라우드 PC 구성을 적용하기 위해 다음 레지스트리 키를 읽을 수 있습니다.

기능	레지스트리 키
클립보드	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 다음 의미 체계를 사용하여 해석됩니다.

• Off 값: 0
• 값: 1
• 값 없음(기본값): 1

메서드

GetForLaunchUri(Uri, WindowId)	원격 데스크톱 연결과 연결된 RemoteDesktopConnectionInfo 를 검색하고 원격 데스크톱을 나타내는 OS에 창을 등록합니다.
PerformLocalActionFromRemote(RemoteDesktopLocalAction)	로컬 데스크톱의 원격 데스크톱 연결을 나타냅니다. 중요 RemoteDesktopConnectionInfo API는 제한된 액세스 기능의 일부입니다(LimitedAccessFeatures 클래스 참조). 자세한 내용을 보거나 잠금 해제 토큰을 요청하려면 LAF 액세스 토큰 요청 양식을 사용하세요.
SetConnectionStatus(RemoteDesktopConnectionStatus)	RemoteDesktopConnectionInfo와 연결된 원격 데스크톱 연결에 대한 연결 상태 설정합니다.
SwitchToLocalSession()	사용자가 로컬 세션으로 전환하도록 요청했음을 OS에 알 수 있습니다.