IMsRdpExtendedSettings::P roperty 속성

명명된 속성을 포함합니다.

이 속성은 읽기/쓰기가 가능합니다.

통사론

HRESULT put_Property(
  [in]          BSTR    bstrPropertyName,
  [in]          VARIANT *pValue
);

HRESULT get_Property(
  [in]          BSTR    bstrPropertyName,
  [out, retval] VARIANT *pValue
);

속성 값

명명된 속성 값입니다.

속성 이름	데이터 형식	접근	연결이 시작된 후 변경할 수 있습니다.	묘사
ConnectToChildSession	VT_BOOL	읽기/쓰기	예	이 속성을 True 설정하면 클라이언트 컨트롤이 원격 서버 대신 로컬 컴퓨터의 자식 세션에 연결됩니다. 이 속성이 true설정되면 모든 연결이 localhost로 리디렉션되므로 원격 서버에 연결할 수 없습니다. 자식 세션에 대한 자세한 내용은 자식 세션참조하세요.
DisableCredentialsDelegation	VT_BOOL	읽기/쓰기	아니요	true경우 자격 증명이 원격 서버로 전송되지 않습니다.
EnableFrameBufferRedirection	VT_BOOL	읽기/쓰기	아니요	true경우 프레임 버퍼 리디렉션이 시도됩니다. 루프백 연결의 경우(동일한 컴퓨터가 클라이언트와 서버 모두임) 프레임 버퍼 리디렉션을 사용하면 프레임 버퍼의 메모리를 세션 간에 공유할 수 있습니다.
EnableHardwareMode	VT_BOOL	쓰기 전용	아니요	true경우 하드웨어에서 그래픽 디코딩을 지원합니다.
IgnoreCursors	VT_BOOL	쓰기 전용	아니요	true경우 원격 서버에서 보낸 커서는 무시됩니다.
ManualClipboardSyncEnabled	VT_BOOL	읽기/쓰기	예	이 속성을 True 설정하면 로컬 및 원격 클립보드가 자동으로 동기화되지 않습니다. 대신 IMsRdpClipboard 인터페이스를 사용하여 로컬 클립보드에서 원격 클립보드로 클립보드 형식을 동기화하고 원격 클립보드를 로컬 클립보드로 동기화해야 합니다.
ZoomLevel	* VT_UI4	읽기/쓰기	예	RDP ActiveX 컨트롤을 사용하여 확대/축소 기능을 구현합니다. 확대/축소 기능은 RDP의 시스템 메뉴에서 사용할 수 있습니다. ZoomLevel 속성은 RemoteApp 모드 및 전체 화면 모드에 영향을 주지 않습니다. IMsRdpClientAdvancedSettings::SmartSizing 및 ZoomLevel 함께 사용할 수 없습니다.
DisableSeamlessLanguageBar	VT_BOOL	R/W	아니요	True경우 로컬 언어를 원격 세션에 자동으로 동기화하는 대신 RemoteApp 연결이 Windows 8 이전의 레거시 언어 모음으로 되돌아갑니다.
RedirectTextProcessing	VT_BOOL	W	아니요	Windows 11 23H2부터 텍스트 입력 시나리오(예: IME, 이모티콘)에 대해 같은 로컬 환경을 제공하는 텍스트 처리 리디렉션을 사용하거나 사용하지 않도록 설정합니다.
HvSocketServiceId	VT_BSTR	W	아니요	RDP 트래픽을 보낼 Hyper-V 소켓주소의 ServiceId 필드를 지정합니다.
DeviceScaleFactor	VT_UI4	R/W	아니요	원격 세션에서 사용되는 디바이스 배율 인수 지정합니다. 유효한 값: 100, 140, 180
EnableLocationRedirection	VT_BOOL	R/W	아니요	로컬 컴퓨터의 위치가 원격 세션으로 리디렉션되도록 설정/해제합니다.
AudioCaptureDevice	VT_BSTR	R/W	아니요	클라이언트에서 원격 세션으로 리디렉션할 오디오 캡처 디바이스의 디바이스 ID를 지정합니다. 애플리케이션은 DRV_QUERYFUNCTIONINSTANCEID 메시지를 사용하여 리디렉션할 오디오 캡처 디바이스의 디바이스 ID를 확인할 수 있습니다. 또는 기본 디바이스를 사용하도록 "기본값"으로 설정하거나 오디오 캡처를 사용하지 않도록 설정하는 "없음"으로 설정할 수 있습니다. 기본적으로 "기본값"으로 설정됩니다.
RailMode	VT_BOOL	R	아니요	RemoteApp 연결인지 여부를 보고합니다. itsRemoteProgram::RemoteProgramMode 이 속성에 씁니다.
EnableRdsAadAuth	VT_BOOL	W	아니요	true경우 RDS AAD 인증 보안 사용됩니다.
RDGIsKDCProxy	VT_BOOL	W	아니요	true경우 클라이언트에 RD 게이트웨이(지정된 경우)를 KDC 프록시 서버사용하도록 지시합니다.
UseURCP	VT_BOOL	R/W	아니요	true경우 이 속성을 사용하면 UDP 기반 원격 데스크톱 연결에 대한 범용 속도 제어 프로토콜을 사용할 수 있습니다. 현재는 기본적으로 사용하지 않도록 설정되어 있습니다. UDP를 사용하는 경우 사용하도록 설정하는 것이 좋습니다.
DesktopScaleFactor	VT_UI4	R/W	아니요	원격 세션에서 사용되는 디바이스 배율 인수 지정합니다. 값은 100에서 500(백분율) 사이여야 합니다.
RedirectedAuthentication	VT_BOOL	W	아니요	true경우 Remote Credential Guard 사용하도록 설정됩니다.
RestrictedLogon	VT_BOOL	W	아니요	true경우 제한된 관리 모드 사용하도록 설정됩니다.
AudioPlaybackDevice	VT_BSTR	R/W	아니요	로컬 컴퓨터에서 오디오 재생 디바이스의 디바이스 ID를 지정합니다. 애플리케이션은 DRV_QUERYFUNCTIONINSTANCEID 메시지를 사용하여 리디렉션할 오디오 재생 디바이스의 디바이스 ID를 확인할 수 있습니다. "또는 기본 디바이스를 사용하도록 "기본값"으로 설정하거나 "없음"으로 설정하여 오디오 재생을 사용하지 않도록 설정할 수 있습니다. 기본적으로 "기본값"으로 설정됩니다. "
SelectedMonitors	VT_BSTR	R/W	아니요	쉼표로 구분된 또는 반열로 구분된 모니터 ID 목록으로, 선택한 모니터를 식별하여 원격 세션을 표시할 위치를 식별합니다. 목록의 첫 번째 ID는 원격 세션에서 기본 모니터로 처리됩니다.
WslgModeEnabled	VT_BOOL	W	아니요	true경우 세션은 WSLg 세션입니다. 다음 속성이 제공되어야 합니다. WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId WSLg의 설명서 https://github.com/microsoft/wslg참조하세요.
ShowSessionDiagnostics	VT_BOOL	W	예	이 속성에 True 작성하면 원격 세션에 대한 자세한 정보가 포함된 대화 상자가 즉시 표시됩니다. 이 속성은 디버깅 메커니즘을 의미 합니다. 변경 및 제거될 수 있습니다.
PrintingProgressMode	VT_UI4	R/W	아니요	가능한 값: 0: 인쇄를 사용하지 않도록 설정할 때 표시되는 진행률 대화 상자 1: 인쇄할 때 표시되는 진행률 대화 상자에 기본 정보가 포함됩니다. 2: 인쇄할 때 표시되는 진행률 대화 상자에 자세한 정보가 포함되어 있습니다.
CorrelationId	VT_BOOL	W	아니요	IMsRdpClientNonScriptable8::CorrelationId에서 반환된 값을 재정의합니다.
RequestUseNewOutputPresenter	VT_BOOL	W	아니요	true경우 원격 세션은 GDI로 대체하지 않고 DirectX를 사용하여 표시됩니다. 이 속성은 원격 앱 세션에 적용되지 않습니다. 참고: DirectX 전용 모드가 사용 가능한 유일한 옵션이 될 수 있으므로 이 속성은 이후 버전의 Windows에서 제거될 수 있습니다. 현재 프로덕션 코드에서 사용하도록 설정하면 안 되는 미리 보기 기능입니다.
GatewayCertificateLogonAuthority	VT_BSTR	W	아니요	이 속성은 더 이상 지원되지 않습니다. 이후 버전의 Windows에서는 제거될 수 있습니다. 이 속성을 사용하지 마세요.
EnableRemoteEdgeBar	VT_BOOL	R/W	아니요	True 및 ServerSupportsEdgeActions 속성이 true경우 원격 세션의 연결 도구 모음에 추가 명령이 표시됩니다.
TSGTransportIsUsed	VT_BOOL	R	해당(N/A)	true경우 연결된 원격 세션에 원격 데스크톱 게이트웨이가 사용됩니다.
DiagnosticsInfo	VT_BSTR	W	아니요	클라이언트 X.224 연결 요청 PDUrdpCorrelationInfo.correlationId 필드를 나타내는 16진수 문자열입니다.
EndpointFedAuth	VT_BSTR	W	아니요	클레임 기반 페더레이션 RDSTLS 인증사용되는 토큰입니다.
AllowAxToContainerEvents	VT_BOOL	W	아니요	이 속성은 Windows 11 22H2에 추가되었습니다. False(Windows 11 22H2부터 기본 동작)경우 Ctrl+Alt+화살표 키 조합이 원격 세션으로 전송됩니다. true(Windows 11 22H2 이전의 기본 동작)경우 Ctrl+ALT+화살표 키 조합은 IMsTscAxEvents::OnFocusReleased 이벤트를 애플리케이션에 발생시킵니다.
ServerSupportsEdgeActions	VT_BOOL	R	해당(N/A)	원격 세션에 https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 기능이 있는지 여부를 확인하는 읽기 전용 속성입니다.
AppContainerID	VT_BSTR	W	아니요	IMsRdpClientNonScriptable8::StartWorkspaceExtension 호출될 때 IWorkspaceScriptable3::StartWorkspaceEx2 전달된 AppContainer ID입니다. 참고: RemoteApp 및 데스크톱 연결 제어판은 더 이상 활성 개발 중이 아닙니다. 이후 버전의 Windows에서는 변경되거나 사용할 수 없습니다. 이 API의 사용은 권장되지 않습니다.
IgnoreServerGeneratedMouseMoves	VT_BOOL	R/W	아니요	true경우 원격 세션에서 프로그래밍 방식으로 생성된 마우스 이동은 무시됩니다. 더 정확하게 말하면 포인터 위치 업데이트 PDU가 적용되지 않습니다. https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c참조하세요.
RDmiDiagnosticsUrl	VT_BSTR	W	아니요	이 속성은 더 이상 지원되지 않습니다. 이후 버전의 Windows에서는 제거될 수 있습니다. 이 속성을 사용하지 마세요.
EnableVailMonitorConfig	VT_BOOL	R/W	아니요	true경우 디스플레이 구성을 동기화할 때 확장 모니터 정보(예: EDID)가 원격 세션으로 전송됩니다.
작업 영역 ID	VT_BSTR	W	아니요	RemoteApp 및 데스크톱 연결에서 연결의 고유 식별자는 원격 세션이 속한.
ShowConnectionInformation	VT_BOOL	W	예	이 속성에 True 작성하면 연결 정보 대화 상자가 표시됩니다.
WslgSharedMemoryPath	VT_BSTR	W	아니요	WSLg 가상 머신과 그래픽 버퍼를 공유할 메모리 세션 개체의 경로입니다.
HiDefRemoteAppContainerGUID	VT_BSTR	W	아니요	원격 애플리케이션을 호스트하는 실행 중인 VM과 연결된 GUID입니다. 이 속성을 작성하면 메모리 공유로 인해 로컬 VM에서 실행되는 원격 애플리케이션의 성능이 향상됩니다.
KDCProxyName	VT_BSTR	W	아니요	"KDC(키 배포 센터) 프록시 서버의 정규화된 도메인 이름을 지정합니다. KDC 프록시를 사용하면 RDP 클라이언트가 KDC에 직접 액세스할 수 없는 경우 Kerberos 인증 프로토콜을 사용할 수 있습니다.  속성 값의 예: ""kdc.contoso.com"" 자세한 내용은 다음을 참조하세요. Kerberos 키 배포 센터 프록시구성 , https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38
DisableTouchRemoting	VT_BOOL	R/W	아니요	True경우 멀티 터치 스크린의 제스처는 원격 서버로 전송되지 않습니다. 기본적으로 False설정됩니다.
HvSocketEnabled	VT_BOOL	W	아니요	true경우 원격 서버의 이름이 GUID인 경우 RDP 트래픽을 보낼 Hyper-V 소켓 주소의 VmId 필드로 해석됩니다. 기본적으로 False설정됩니다. Hyper-V 소켓의 주소에 대한 자세한 내용은 Hyper-V 소켓바인딩을 참조하세요.
MultipenRemotingSupported	VT_BOOL	W	아니요	true경우 원격 세션에서 최대 4개의 펜 디바이스에서 입력을 동시에 삽입할 수 있습니다. 기본적으로 False설정됩니다.
ShowGatewayInformation	VT_BOOL	W	예	이 속성에 True 작성하면 원격 데스크톱 게이트웨이에 대한 정보를 보여 주는 대화 상자가 표시됩니다. Windows 11 22H2 이상: 이 속성은 더 이상 지원되지 않으며 ShowConnectionInformation 속성으로 대체되었습니다.
DisableAutoReconnectComponent	VT_BOOL	W	아니요	true경우 네트워크 구성이 변경될 때 서버 연결이 끊기고 자동으로 다시 연결되지 않습니다. 기본적으로 False설정됩니다.
RedirectUsbDrive	VT_UI4	R/W	아니요	Windows 11 버전 24H2에 도입되었습니다. 0으로 설정하거나 설정하지 않으면 USB 썸 드라이브가 드라이브 방향으로 리디렉션됩니다. 1로 설정하면 모든 USB 썸 드라이브가 자동으로 USB 디바이스로 리디렉션됩니다. 2로 설정하면 USB 썸 드라이브가 USB 디바이스로 나열되고, 사용자는 UI(연결 표시줄의 디바이스 대화 상자) 또는 RDP 파일 항목 "UsbDevicesToRedirect"에서 USB 리디렉션을 통해 리디렉션하도록 선택할 수 있습니다.
허용되는 보안 프로토콜	VT_BSTR	W	아니요	Windows 11 버전 24H2에 도입되었습니다. 이 속성은 클라이언트가 협상할 수 있는 보안 프로토콜 목록을 제한하는 데 사용됩니다. 협상된 프로토콜의 실제 목록은 다른 구성 설정 및 연결 시나리오에 따라 결정되며 이 속성에 지정된 목록보다 작을 수 있습니다. 값은 ';'로 구분된 프로토콜 이름 목록을 포함해야 합니다. 또는 값이 ""로 설정될 수 있습니다. 즉, 일반적으로 협상된 모든 프로토콜이 허용됩니다. 지원되는 프로토콜 이름은 "TLS", "CredSSP", "RDSTLS" 및 "RDS AAD 인증"입니다. 기본값은 ""입니다.
AllowRelativeMouseMode	VT_BOOL	R/W	아니요	Windows 11 버전 24H2에 도입되었습니다. True이면 마우스 이동이 현재 마우스 위치를 기준으로 표시됩니다.
RemoteAppMouseMoveInject	VT_BOOL	W	아니요	Windows 11 버전 24H2에 도입되었습니다. 이 속성에 True를 쓰면 커서가 RemoteApp 창을 떠날 때 마우스 이동이 강제로 적용됩니다. 이는 도구 설명 버그에 대한 해결 방법입니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
형식 라이브러리	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7NotSafeForScripting 54d38bf7-b1ef-4479-9674-1bd6ea465258로 정의됩니다. CLSID_MsRdpClient8NotSafeForScripting A3BC03A0-041D-42E3-AD22-882B7865C9C5로 정의됩니다. CLSID_MsRdpClient9NotSafeForScripting 8B918B82-7985-4C24-89DF-C33AD2BBFBCD 정의됩니다.
IID	IID_IMsRdpExtendedSettings 302D8188-0052-4807-806A-362B628F9AC5로 정의됩니다.

참고 항목

IMsRdpExtendedSettings