структура 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
Указывает, что смарт-карта использовался во время входа в систему. Смарт-код карта — это пароль. Это значение используется, если параметр fInheritAutoLogon имеет значение TRUE.
fPromptForPassword
Указывает, следует ли запрашивать у пользователя пароль. Если это значение равно TRUE, пользователю будет предложено, даже если значение реестра fInheritAutoLogon равно TRUE и политика "Всегда запрашивать пароль" не задана.
fDisableCpm
Указывает, включено ли сопоставление принтеров. Это значение изначально задается из сведений о политике. При сбросе значения политика будет перезаписана.
fDisableCdm
Указывает, включено ли сопоставление дисков. Это значение изначально задается из сведений о политике. При сбросе значения политика будет перезаписана.
fDisableCcm
Указывает, включено ли сопоставление COM-портов. Это значение изначально задается из сведений о политике. При сбросе значения политика будет перезаписана.
fDisableLPT
Указывает, включено ли перенаправление принтера LPT. Это значение изначально задается из сведений о политике. При сбросе значения политика будет перезаписана.
fDisableClip
Указывает, включено ли перенаправление буфера обмена. Это значение изначально задается из сведений о политике. При сбросе значения политика будет перезаписана.
fResetBroken
Указывает действие, выполняемое сервером при истечении срока действия таймера подключения или простоя или при потере соединения из-за ошибки подключения.
Ложь.
Сеанс отключен, но остается на сервере.
TRUE
Сеанс завершается.
fDisableEncryption
Указывает, следует ли отключить шифрование для обмена данными между клиентом и сервером.
fDisableAutoReconnect
Указывает, следует ли отключить автоматическое повторное подключение клиента.
fDisableCtrlAltDel
Указывает, отключено ли сочетание клавиш CTRL+ALT+DELETE.
fDoubleClickDetect
Указывает, может ли клиент дважды щелкнуть.
fEnableWindowsKey
Указывает, включен ли ключ Windows.
fUsingSavedCreds
Указывает, использует ли клиент сохраненные учетные данные во время входа в систему.
fMouse
Указывает, включен ли ввод с помощью мыши.
fNoAudioPlayback
Указывает, следует ли включать воспроизведение звука. Значение TRUE указывает отсутствие звука.
fRemoteConsoleAudio
Указывает, следует ли оставить воспроизведение звука на удаленном компьютере.
EncryptionLevel
Указывает уровень шифрования.
ColorDepth
Задает глубину цвета клиентского монитора. Возможные значения см. в элементе ColorDepth структуры WTS_CLIENT_DISPLAY .
ProtocolType
Указывает тип протокола.
HRes
Задает горизонтальное разрешение клиентского монитора.
VRes
Задает вертикальное разрешение клиентского монитора.
ClientProductId
Идентификатор продукта клиентского программного обеспечения.
OutBufCountHost
Количество выходных буферов на узле.
OutBufCountClient
Количество выходных буферов на клиенте.
OutBufLength
Длина выходных буферов в байтах.
KeyboardLayout
Указывает раскладку клавиатуры.
MaxConnectionTime
Максимальная продолжительность сеанса служб удаленных рабочих столов в минутах.
MaxDisconnectionTime
Максимальное время в минутах, в течение которых отключенный сеанс служб удаленных рабочих столов остается активным на сервере узла сеансов удаленных рабочих столов.
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
Указывает идентификатор входного языкового стандарта. Слово low содержит идентификатор языка, а высокое слово — дескриптор устройства для физической раскладки клавиатуры.
SerialNumber
Уникальный серийный номер клиентского компьютера.
ClientAddressFamily
Семейство IP-адресов клиента.
ClientBuildNumber
Номер сборки клиента.
ClientSessionId
Идентификатор сеанса клиента.
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]
Строка, содержащая 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) |