IMsRdpClientAdvancedSettings 인터페이스
고급 클라이언트 설정을 관리합니다. IMsTscAdvancedSettings 인터페이스에서 파생됩니다. 이 인터페이스에는 원격 데스크톱 ActiveX 컨트롤에 대한 고급(선택 사항) 속성을 검색하고 설정하는 메서드가 포함되어 있습니다.
이 인터페이스의 instance 가져오려면 IMsTscAx::AdvancedSettings 속성을 사용하여 IMsTscAdvancedSettings 인터페이스 포인터를 가져옵니다. 그런 다음, IMsTscAdvancedSettings 포인터에서 QueryInterface를 호출하고 IID_IMsRdpClientAdvancedSettingsQueryInterface에 전달합니다.
멤버
IMsRdpClientAdvancedSettings 인터페이스는 IMsTscAdvancedSettings에서 상속됩니다. IMsRdpClientAdvancedSettings 에는 다음과 같은 유형의 멤버도 있습니다.
속성
IMsRdpClientAdvancedSettings 인터페이스에는 이러한 속성이 있습니다.
| 속성 | 액세스 유형 | 설명 |
|---|---|---|
| AcceleratorPassthrough |
읽기/쓰기 |
키보드 가속기를 서버에 전달해야 하는지를 지정합니다. |
| BitmapCacheSize |
읽기/쓰기 |
픽셀당 8비트 비트맵에 사용되는 비트맵 캐시 파일의 크기(킬로바이트)입니다. 이 속성의 유효한 숫자 값은 1에서 32까지 포함됩니다. |
| BitmapPersistence |
읽기/쓰기 |
영구 비트맵 캐싱을 사용해야 하는지 지정합니다. 영구 캐싱은 성능을 향상시킬 수 있지만 추가 디스크 공간이 필요합니다. |
| BitmapVirtualCache16BppSize |
읽기/쓰기 |
픽셀당 15비트 및 16비트 고색 설정에 사용할 영구 비트맵 캐시 파일의 크기를 메가바이트 단위로 지정합니다. |
| BitmapVirtualCache24BppSize |
읽기/쓰기 |
픽셀당 24비트 고색 설정에 사용할 영구 비트맵 캐시 파일의 크기(메가바이트)를 지정합니다. |
| BitmapVirtualCacheSize |
읽기/쓰기 |
픽셀당 8비트 색에 사용할 영구 비트맵 캐시 파일의 크기(메가바이트)를 지정합니다. 이 속성의 유효한 숫자 값은 1에서 32까지 포함됩니다. 모든 가상 캐시 파일의 최대 크기는 128MB입니다. 관련 속성에는 BitmapVirtualCache16BppSize 및 BitmapVirtualCache24BppSize 속성이 포함됩니다. |
| brushSupportLevel |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| CachePersistenceActive |
읽기/쓰기 |
영구 비트맵 캐싱을 사용할지 여부를 지정합니다. |
| ClearTextPassword |
쓰기 전용 |
연결할 암호를 지정합니다. 자세한 내용은 IMsTscNonScriptable 인터페이스를 참조하세요. |
| ConnectToServerConsole |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| ConnectWithEndpoint |
쓰기 전용 |
이 속성이 지원되지 않는 경우 |
| DedicatedTerminal |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| DisableCtrlAltDel |
읽기/쓰기 |
Winlogon의 초기 설명 화면이 표시되어야 하는지를 지정합니다. |
| DisplayConnectionBar |
읽기/쓰기 |
연결 표시줄을 사용할지 여부를 지정합니다. 기본값은 속성을 사용하도록 설정하는 VARIANT_TRUE. |
| DoubleClickDetect |
읽기/쓰기 |
클라이언트가 서버에 대한 두 번 클릭을 식별하는지 지정합니다. |
| EnableMouse |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| EnableWindowsKey |
읽기/쓰기 |
원격 세션에서 Windows 키를 사용할 수 있는지를 지정합니다. |
| EncryptionEnabled |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 암호화를 사용하지 않도록 설정할 수 없습니다. |
| GrabFocusOnConnect |
읽기/쓰기 |
연결하는 동안 클라이언트 컨트롤에 포커스가 있어야 하는지를 지정합니다. |
| HotKeyAltEsc |
읽기/쓰기 |
ALT+ESC의 핫키 대체를 결정하기 위해 ALT에 추가할 가상 키 코드를 지정합니다. VK_INSERT 기본값이며 ALT+INSERT를 결과 시퀀스로 사용합니다. 이 속성은 KeyboardHookMode 속성을 사용할 수 없는 경우에만 유효합니다. |
| HotKeyAltShiftTab |
읽기/쓰기 |
ALT+Shift+TAB의 핫키 대체를 결정하기 위해 ALT에 추가할 가상 키 코드를 지정합니다. VK_NEXT 기본값이며 ALT+PAGE DOWN을 결과 시퀀스로 사용합니다. 이 속성은 KeyboardHookMode 속성을 사용할 수 없는 경우에만 유효합니다. |
| HotKeyAltSpace |
읽기/쓰기 |
ALT+SPACE의 핫키 대체를 결정하기 위해 ALT에 추가할 가상 키 코드를 지정합니다. VK_DELETE 기본값이며 ALT+DELETE를 결과 시퀀스로 사용합니다. 이 속성은 KeyboardHookMode 속성을 사용할 수 없는 경우에만 유효합니다. |
| HotKeyAltTab |
읽기/쓰기 |
ALT+TAB의 핫키 대체를 결정하기 위해 ALT에 추가할 가상 키 코드를 지정합니다. VK_PRIOR 기본값이며 ALT+PAGE UP을 결과 시퀀스로 사용합니다. 이 속성은 KeyboardHookMode 속성을 사용할 수 없는 경우에만 유효합니다. |
| HotKeyCtrlAltDel |
읽기/쓰기 |
CTRL+ALT에 추가할 가상 키 코드를 지정하여 CTRL+ALT+DELETE의 핫키 대체를 결정하며, 이를 SAS(보안 주의 시퀀스)라고도 합니다. VK_END 기본값입니다. KeyboardHookMode 속성을 사용하도록 설정한 경우에도 Ctrl+Alt+DELETE는 원격 서버로 리디렉션되지 않습니다. Ctrl+Alt+DELETE는 로컬 SAS 시퀀스입니다. |
| HotKeyCtrlEsc |
읽기/쓰기 |
CTRL+ESC의 핫키 대체를 결정하기 위해 ALT에 추가할 가상 키 코드를 지정합니다. VK_HOME 기본값이며 ALT+HOME을 결과 시퀀스로 사용합니다. 이 속성은 KeyboardHookMode 속성을 사용할 수 없는 경우에만 유효합니다. |
| HotKeyFullScreen |
읽기/쓰기 |
전체 화면 모드로 전환하기 위한 핫키 대체를 결정하기 위해 Ctrl+ALT에 추가할 가상 키 코드를 지정합니다. VK_CANCEL 기본값입니다. |
| InputEventsAtOnce |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| keepAliveInterval |
읽기/쓰기 |
클라이언트가 서버에 연결 유지 메시지를 보내는 간격(밀리초)을 지정합니다. 속성의 기본값은 0이며, 이 값은 연결 유지 메시지를 사용하지 않도록 설정합니다. 이 속성의 유효한 최소값은 10,000이며 10초를 나타냅니다. 서버에 대한 영구 클라이언트 연결이 허용되는지 여부를 지정하는 그룹 정책 설정은 이 속성 설정을 재정의할 수 있습니다. |
| KeyboardFunctionKey |
읽기/쓰기 |
Windows CE 경우에만 유효합니다. |
| KeyboardSubType |
읽기/쓰기 |
Windows CE 경우에만 유효합니다. |
| KeyboardType |
읽기/쓰기 |
Windows CE 경우에만 유효합니다. |
| LoadBalanceInfo |
읽기/쓰기 |
RD 세션 호스트 서버 프로토콜 연결 시퀀스의 X.224 연결 요청 패킷에 배치될 부하 분산 쿠키를 지정합니다. |
| maxEventCount |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| 최대화Shell |
읽기/쓰기 |
StartProgram 속성을 사용하여 시작된 프로그램을 최대화할지를 지정합니다. |
| minInputSendInterval |
읽기/쓰기 |
마우스 이벤트 전송 사이의 최소 간격(밀리초)을 지정합니다. |
| MinutesToIdleTimeout |
읽기/쓰기 |
클라이언트가 사용자 입력 없이 연결 상태를 유지해야 하는 최대 시간(분)을 지정합니다. 지정된 시간이 경과하면 컨트롤은 IMsTscAxEvents::OnIdleTimeoutNotification 메서드를 호출합니다. |
| NotifyTSPublicKey |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| NumBitmapCaches |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| orderDrawThreshold |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| overallConnectionTimeout |
읽기/쓰기 |
클라이언트 컨트롤이 연결이 완료되기를 기다리는 총 시간(초)을 지정합니다. 이 속성의 유효한 최대 값은 10분을 나타내는 600입니다. 연결이 완료되기 전에 지정된 시간이 경과하면 컨트롤이 연결을 끊고 IMsTscAxEvents::OnDisconnected 메서드를 호출합니다. 관련 속성은 singleConnectionTimeout입니다. |
| PerformanceFlags |
읽기/쓰기 |
성능을 향상시키기 위해 서버에서 설정할 수 있는 기능 집합을 지정합니다. |
| PersistCacheDirectory |
쓰기 전용 |
이 속성이 지원되지 않는 경우 |
| PinConnectionBar |
읽기/쓰기 |
UI 연결 표시줄의 상태를 지정합니다. 이 속성을 VARIANT_TRUE 설정하면 상태가 "낮아지게" 설정됩니다. 즉, 사용자에게 표시되지 않으며 입력에 사용할 수 없습니다. VARIANT_FALSE 상태를 "발생"으로 설정하고 사용자 입력에 사용할 수 있습니다. |
| RdpdrClipCleanTempDirString |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| RdpdrClipPasteInfoString |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| RdpdrLocalPrintingDocName |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| RDPPort |
읽기/쓰기 |
연결 포트를 지정합니다. 기본값은 3389입니다. |
| RedirectDrives |
읽기/쓰기 |
디스크 드라이브의 리디렉션이 허용되는지 지정합니다. |
| RedirectPorts |
읽기/쓰기 |
로컬 포트(예: COM 및 LPT)의 리디렉션이 허용되는지 지정합니다. |
| RedirectPrinters |
읽기/쓰기 |
프린터 리디렉션이 허용되는지 지정합니다. |
| RedirectSmartCards |
읽기/쓰기 |
스마트 카드의 리디렉션이 허용되는지 지정합니다. |
| SasSequence |
읽기/쓰기 |
클라이언트가 서버의 로그인 화면에 액세스하는 데 사용할 보안 액세스 순서를 지정합니다. |
| ScaleBitmapCachesByBPP |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| ShadowBitmap |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 Windows Vista: 섀도 비트맵을 사용해야 하는지 지정합니다. |
| shutdownTimeout |
읽기/쓰기 |
서버가 연결 끊김 요청에 응답할 때까지 대기하는 시간(초)을 지정합니다. 속성의 기본값은 10입니다. 속성의 유효한 최대 값은 10분을 나타내는 600입니다. 지정된 시간 내에 서버가 응답하지 않으면 클라이언트 컨트롤의 연결이 끊어집니다. |
| singleConnectionTimeout |
읽기/쓰기 |
클라이언트 컨트롤이 IP 주소에 대한 연결을 기다리는 최대 시간(초)을 지정합니다. 연결 중에 컨트롤이 여러 IP 주소에 연결을 시도할 수 있습니다. 이 속성의 유효한 최대 값은 600입니다. 관련 속성은 overallConnectionTimeout입니다. |
| SmartSizing |
읽기/쓰기 |
컨트롤의 클라이언트 영역에 맞게 디스플레이 크기를 조정해야 하는지 지정합니다. VARIANT_TRUE 크기 조정을 사용하도록 설정합니다. SmartSizing 속성을 사용하면 스크롤 막대가 표시되지 않습니다. |
| SmoothScroll |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
| TransportType |
읽기/쓰기 |
클라이언트에서 사용하는 전송 유형을 지정합니다. 이 속성은 원격 데스크톱 ActiveX 컨트롤에서 사용되지 않습니다. |
| WinCEFixedPalette |
읽기/쓰기 |
Windows CE 경우에만 유효합니다. |
설명
이 인터페이스는 다음 인터페이스에 의해 확장되었으며, 각 새 인터페이스는 이전 인터페이스의 모든 메서드와 속성을 상속합니다.
- IMsRdpClientAdvancedSettings2
- IMsRdpClientAdvancedSettings3
- IMsRdpClientAdvancedSettings4
- IMsRdpClientAdvancedSettings5
- IMsRdpClientAdvancedSettings6
- IMsRdpClientAdvancedSettings7
- IMsRdpClientAdvancedSettings8
컨트롤이 연결될 때 달리 표시되지 않는 한 이 속성을 설정할 수 없습니다.
원격 데스크톱 웹 연결에 대한 자세한 내용은 원격 데스크톱 웹 연결에 대한 요구 사항을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_IMsRdpClientAdvancedSettings 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2로 정의됩니다. |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기