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로 정의됩니다. |