WRDS_CONNECTION_SETTINGS_1 구조체(wtsdefs.h)
원격 세션에 대한 연결 설정 정보를 포함합니다.
구문
typedef struct _WRDS_CONNECTION_SETTINGS_1 {
BOOLEAN fInheritInitialProgram;
BOOLEAN fInheritColorDepth;
BOOLEAN fHideTitleBar;
BOOLEAN fInheritAutoLogon;
BOOLEAN fMaximizeShell;
BOOLEAN fDisablePNP;
BOOLEAN fPasswordIsScPin;
BOOLEAN fPromptForPassword;
BOOLEAN fDisableCpm;
BOOLEAN fDisableCdm;
BOOLEAN fDisableCcm;
BOOLEAN fDisableLPT;
BOOLEAN fDisableClip;
BOOLEAN fResetBroken;
BOOLEAN fDisableEncryption;
BOOLEAN fDisableAutoReconnect;
BOOLEAN fDisableCtrlAltDel;
BOOLEAN fDoubleClickDetect;
BOOLEAN fEnableWindowsKey;
BOOLEAN fUsingSavedCreds;
BOOLEAN fMouse;
BOOLEAN fNoAudioPlayback;
BOOLEAN fRemoteConsoleAudio;
BYTE EncryptionLevel;
USHORT ColorDepth;
USHORT ProtocolType;
USHORT HRes;
USHORT VRes;
USHORT ClientProductId;
USHORT OutBufCountHost;
USHORT OutBufCountClient;
USHORT OutBufLength;
ULONG KeyboardLayout;
ULONG MaxConnectionTime;
ULONG MaxDisconnectionTime;
ULONG MaxIdleTime;
ULONG PerformanceFlags;
ULONG KeyboardType;
ULONG KeyboardSubType;
ULONG KeyboardFunctionKey;
ULONG ActiveInputLocale;
ULONG SerialNumber;
ULONG ClientAddressFamily;
ULONG ClientBuildNumber;
ULONG ClientSessionId;
WCHAR WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
WCHAR UserName[WTS_USERNAME_LENGTH + 1];
WCHAR Domain[WTS_DOMAIN_LENGTH + 1];
WCHAR Password[WTS_PASSWORD_LENGTH + 1];
WCHAR ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
WCHAR DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
WCHAR imeFileName[WTS_IMEFILENAME_LENGTH + 1];
WCHAR AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR ClientName[WTS_CLIENTNAME_LENGTH + 1];
WCHAR ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
WCHAR ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
WRDS_SOCKADDR ClientSockAddress;
WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
WRDS_LISTENER_SETTINGS WRdsListenerSettings;
GUID EventLogActivityId;
#if ...
ULONG ContextSize;
#if ...
PBYTE ContextData;
#else
ULONG ContextSize;
#endif
#else
PBYTE ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;
멤버
fInheritInitialProgram
원격 데스크톱 서비스 셸에서 시작할 초기 프로그램이 상속되는지 여부를 지정합니다. 이 값은 fInheritInitialProgram 수신기 레지스트리 값을 덮어씁니다.
fInheritColorDepth
모니터 색 깊이를 상속할지 여부를 지정합니다. 이 값은 fInheritColorDepth 수신기 레지스트리 값을 덮어씁니다.
fHideTitleBar
제목 표시줄을 숨길지 여부를 지정합니다.
fInheritAutoLogon
로그온 프로세스가 자동인지 여부를 지정합니다. 이 값은 fInheritAutoLogon 수신기 레지스트리 값을 덮어씁니다.
fMaximizeShell
초기 프로그램이 최대화되어 표시되는지 여부를 지정합니다. 이 값은 fInheritInitialProgram 이 TRUE로 설정된 경우에 사용됩니다.
fDisablePNP
PNP 리디렉션을 사용할지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fPasswordIsScPin
로그온 프로세스 중에 스마트 카드 사용되도록 지정합니다. 스마트 카드 PIN은 암호입니다. 이 값은 fInheritAutoLogon 이 TRUE로 설정된 경우에 사용됩니다.
fPromptForPassword
사용자에게 암호를 묻는 메시지를 표시할지 여부를 지정합니다. 이 값이 TRUE이면 fInheritAutoLogon 레지스트리 값이 TRUE 이고 "항상 암호 요청" 정책이 설정되지 않은 경우에도 사용자에게 메시지가 표시됩니다.
fDisableCpm
프린터 매핑을 사용할지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fDisableCdm
드라이브 매핑을 사용할지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fDisableCcm
COM 포트 매핑을 사용할지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fDisableLPT
LPT 프린터 리디렉션을 사용할 수 있는지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fDisableClip
클립보드 리디렉션을 사용할지 여부를 지정합니다. 이 값은 처음에 정책 정보에서 설정됩니다. 값을 다시 설정하면 정책을 덮어씁니다.
fResetBroken
연결 또는 유휴 타이머가 만료되거나 연결 오류로 인해 연결이 끊어질 때 서버에서 수행하는 작업을 지정합니다.
FALSE
세션의 연결이 끊어졌지만 서버에 남아 있습니다.
TRUE
세션이 종료됩니다.
fDisableEncryption
클라이언트와 서버 간의 통신을 위해 암호화를 사용하지 않도록 설정할지 여부를 지정합니다.
fDisableAutoReconnect
클라이언트의 자동 재연결을 사용하지 않도록 설정할지 여부를 지정합니다.
fDisableCtrlAltDel
Ctrl+Alt+Delete 바로 가기 키를 사용할 수 없는지 여부를 지정합니다.
fDoubleClickDetect
클라이언트를 두 번 클릭할 수 있는지 여부를 지정합니다.
fEnableWindowsKey
Windows 키를 사용할 수 있는지 여부를 지정합니다.
fUsingSavedCreds
로그온 프로세스 중에 클라이언트가 저장된 자격 증명을 사용하는지 여부를 지정합니다.
fMouse
마우스 입력을 사용할 수 있는지 여부를 지정합니다.
fNoAudioPlayback
오디오 재생을 켤지 여부를 지정합니다. TRUE 값은 오디오를 지정하지 않습니다.
fRemoteConsoleAudio
원격 컴퓨터에서 오디오 재생을 남길지 여부를 지정합니다.
EncryptionLevel
암호화 수준을 지정합니다.
ColorDepth
클라이언트 모니터 색 깊이를 지정합니다. 가능한 값은 WTS_CLIENT_DISPLAY 구조체의 ColorDepth 멤버를 참조하세요.
ProtocolType
프로토콜 유형을 지정합니다.
HRes
클라이언트 모니터 수평 해상도를 지정합니다.
VRes
클라이언트 모니터 세로 해상도를 지정합니다.
ClientProductId
클라이언트 소프트웨어 제품 ID입니다.
OutBufCountHost
호스트의 출력 버퍼 수입니다.
OutBufCountClient
클라이언트의 출력 버퍼 수입니다.
OutBufLength
출력 버퍼의 길이(바이트)입니다.
KeyboardLayout
키보드 레이아웃을 지정합니다.
MaxConnectionTime
원격 데스크톱 서비스 세션의 최대 기간(분)입니다.
MaxDisconnectionTime
연결이 끊긴 원격 데스크톱 서비스 세션이 RD 세션 호스트 서버에서 활성 상태로 유지되는 최대 시간(분)입니다.
MaxIdleTime
원격 데스크톱 서비스 세션이 유휴 상태로 유지될 수 있는 최대 시간(분)입니다.
PerformanceFlags
성능을 향상시키기 위해 서버에서 설정할 수 있는 기능 집합을 지정합니다. 다음 값 중 하나 이상의 조합일 수 있습니다.
WRDS_PERF_DISABLE_NOTHING(0x00000000)
사용하지 않도록 설정된 기능은 없습니다.
WRDS_PERF_DISABLE_WALLPAPER(0x00000001)
바탕 화면의 배경 화면이 표시되지 않습니다.
WRDS_PERF_DISABLE_FULLWINDOWDRAG(0x00000002)
전체 창 끌기를 사용할 수 없습니다. 창이 이동되면 창 윤곽선만 표시됩니다.
WRDS_PERF_DISABLE_MENUANIMATIONS(0x00000004)
메뉴 애니메이션을 사용할 수 없습니다.
WRDS_PERF_DISABLE_THEMING(0x00000008)
테마를 사용할 수 없습니다.
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS(0x00000010)
향상된 그래픽을 사용하도록 설정합니다.
WRDS_PERF_DISABLE_CURSOR_SHADOW(0x00000020)
커서에 그림자가 표시되지 않습니다.
WRDS_PERF_DISABLE_CURSORSETTINGS(0x00000040)
커서 깜박임이 사용되지 않습니다.
WRDS_PERF_ENABLE_FONT_SMOOTHING(0x00000080)
글꼴 다듬기 사용.
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION(0x00000100)
데스크톱 컴퍼지션을 사용하도록 설정합니다.
KeyboardType
키보드 유형을 지정합니다.
KeyboardSubType
키보드 하위 유형을 지정합니다.
KeyboardFunctionKey
함수 키를 지정합니다.
ActiveInputLocale
입력 로캘 식별자를 지정합니다. 낮은 단어에는 언어 식별자가 포함되고 상위 단어에는 키보드의 실제 레이아웃에 대한 디바이스 핸들이 포함됩니다.
SerialNumber
클라이언트 컴퓨터의 고유한 일련 번호입니다.
ClientAddressFamily
클라이언트 IP 주소 패밀리입니다.
ClientBuildNumber
클라이언트 빌드 번호입니다.
ClientSessionId
클라이언트 세션 ID입니다.
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
초기 프로그램이 있는 디렉터리를 포함하는 문자열입니다. 이 값은 fInheritInitialProgram 이 TRUE로 설정된 경우에 사용됩니다.
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
초기 프로그램의 이름을 지정하는 문자열 값입니다. 이 값은 fInheritInitialProgram 이 TRUE로 설정된 경우에 사용됩니다.
UserName[WTS_USERNAME_LENGTH + 1]
사용자 이름을 지정하는 문자열입니다. 이 값은 fInheritAutoLogon 이 TRUE로 설정된 경우에 사용됩니다.
Domain[WTS_DOMAIN_LENGTH + 1]
사용자의 도메인을 지정하는 문자열입니다. 이 값은 fInheritAutoLogon 이 TRUE로 설정된 경우에 사용됩니다.
Password[WTS_PASSWORD_LENGTH + 1]
사용자 암호를 지정하는 문자열입니다. 이 값은 fInheritAutoLogon 이 TRUE로 설정된 경우에 사용됩니다.
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
프로토콜 이름을 포함하는 문자열입니다.
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
로드할 표시 드라이버의 이름을 지정하는 문자열입니다.
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
디스플레이 디바이스의 이름을 지정하는 문자열입니다.
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
입력 메서드 편집기 이름을 지정합니다.
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
로드할 오디오 드라이버의 이름을 포함하는 문자열입니다.
ClientName[WTS_CLIENTNAME_LENGTH + 1]
클라이언트 컴퓨터의 정규화된 이름을 포함하는 문자열입니다.
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
점선 10진수 형식의 클라이언트 IP 주소를 포함하는 문자열입니다.
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
클라이언트 디렉터리입니다.
클라이언트 디렉터리가 포함된 문자열입니다.
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
클라이언트 제품 식별자를 포함하는 문자열입니다.
ClientSockAddress
소켓 주소 정보를 포함하는 WRDS_SOCKADDR 구조체입니다.
ClientTimeZone
클라이언트 표준 시간대 정보를 포함하는 WRDS_TIME_ZONE_INFORMATION 구조체입니다.
WRdsListenerSettings
수신기 설정을 포함하는 WRDS_LISTENER_SETTINGS 구조체입니다.
EventLogActivityId
ContextSize
ContextData 배열의 크기(바이트)입니다.
ContextData
연결에 대한 컨텍스트 데이터를 포함하는 바이트 배열입니다. 이 배열의 크기는 ContextSize 멤버에 지정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 머리글 | wtsdefs.h(Wtsprotocol.h 포함) |