IMsRdpExtended설정::P roperty 속성

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

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

구문

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

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

속성 값

명명된 속성 값입니다.

속성 이름	데이터 형식	Access	연결이 시작된 후 변경할 수 있습니다.	설명
커넥트ToChildSession	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 모드 및 전체 화면 모드에 영향을 주지 않습니다. IMsRdpClientAdvanced설정::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이면 원격 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 커넥트ion 요청 PDU의 rdpCorrelationInfo.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+ARROW 키 조합이 IMsTscAxEvents::OnFocusReleased 이벤트를 애플리케이션에 발생시킵니다.
ServerSupportsEdgeActions	VT_BOOL	R	해당(N/A)	원격 세션 에 RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 기능이 있는지 여부를 확인하는 읽기 전용 속성입니다 https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411.
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 및 데스크톱 커넥트 연결의 고유 식별자입니다.
Show커넥트ionInformation	VT_BOOL	W	예	이 속성에 True를 쓰면 커넥트 정보 대화 상자가 표시됩니다.
WslgSharedMemoryPath	VT_BSTR	W	아님	WSLg 가상 머신과 그래픽 버퍼를 공유할 메모리 세션 개체의 경로입니다.
HiDefRemoteAppContainerGUID	VT_BSTR	W	아님	원격 애플리케이션을 호스트하는 실행 중인 VM과 연결된 GUID입니다. 이 속성을 작성하면 메모리 공유로 인해 로컬 VM에서 실행되는 원격 애플리케이션의 성능이 향상됩니다.
KDCProxyName	VT_BSTR	W	아님	"KDC(키 배포 센터) 프록시 서버의 정규화된 do기본 이름을 지정합니다. 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 이상: 이 속성은 더 이상 지원되지 않으며 Show커넥트ionInformation 속성으로 대체되었습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
유형 라이브러리	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7Not금고ForScripting은 54d38bf7-b1ef-4479-9674-1bd6ea465258로 정의됩니다. CLSID_MsRdpClient8Not금고ForScripting은 A3BC03A0-041D-42E3-AD22-882B7865C9C5로 정의됩니다. CLSID_MsRdpClient9Not금고ForScripting은 8B918B82-7985-4C24-89DF-C33AD2BBFBCD 정의됩니다.
IID	IID_IMsRdpExtended설정 302D8188-0052-4807-806A-362B628F9AC5로 정의됩니다.

참고 항목

IMsRdpExtended설정