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 세션입니다. 다음 속성이 제공되어야 합니다.
WSLg의 설명서를 https://github.com/microsoft/wslg참조하세요. |
| ShowSessionDiagnostics | VT_BOOL | W | 예 | 이 속성에 True를 쓰면 원격 세션에 대한 자세한 정보가 포함된 대화 상자가 즉시 표시됩니다. 이 속성은 디버깅 메커니즘을 의미 합니다. 변경 및 제거될 수 있습니다. |
| PrintingProgressMode | VT_UI4 | R/W | 아님 | 가능한 값:
|
| 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에 추가되었습니다.
|
| ServerSupportsEdgeActions | VT_BOOL | R | 해당(N/A) | 원격 세션 에 RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 기능이 있는지 여부를 확인하는 읽기 전용 속성입니다 https://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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 |
| 유형 라이브러리 |
|
| 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로 정의됩니다. |