Структура WTSUSERCONFIGA (wtsapi32.h)
Содержит сведения о конфигурации пользователя на сервере контроллера домена или узла сеансов удаленного рабочего стола (узел сеансов удаленных рабочих столов). Эта структура используется функциями WTSQueryUserConfig и WTSSetUserConfig.
Синтаксис
typedef struct _WTSUSERCONFIGA {
DWORD Source;
DWORD InheritInitialProgram;
DWORD AllowLogonTerminalServer;
DWORD TimeoutSettingsConnections;
DWORD TimeoutSettingsDisconnections;
DWORD TimeoutSettingsIdle;
DWORD DeviceClientDrives;
DWORD DeviceClientPrinters;
DWORD ClientDefaultPrinter;
DWORD BrokenTimeoutSettings;
DWORD ReconnectSettings;
DWORD ShadowingSettings;
DWORD TerminalServerRemoteHomeDir;
CHAR InitialProgram[MAX_PATH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR TerminalServerProfilePath[MAX_PATH + 1];
CHAR TerminalServerHomeDir[MAX_PATH + 1];
CHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;
Члены
Source
Значение типа перечисления WTS_CONFIG_SOURCE, указывающего источник сведений о конфигурации, возвращаемых функцией WTSQueryUserConfig.
InheritInitialProgram
Значение, указывающее, может ли клиент указать начальную программу. Этот элемент может быть одним из следующих значений.
0
Клиент не может указать начальную программу. Вместо этого программа, указанная initialProgram, запускается автоматически при входе пользователя на сервер. Сервер регистрирует пользователя, когда пользователь выходит из этой программы.
1
Клиент может указать начальную программу.
AllowLogonTerminalServer
Значение, указывающее, разрешено ли учетной записи пользователя войти на сервер узла сеансов удаленных рабочих стола. Этот элемент может быть одним из следующих значений.
0
Пользователь не может войти в систему.
1
Пользователь может войти в систему.
TimeoutSettingsConnections
Максимальная длительность подключения в миллисекундах. Через минуту до истечения срока действия подключения сервер уведомляет пользователя о ожидании отключения. Когда время ожидания подключения истекло, сервер принимает действие, указанное элементом BrokenTimeoutSettings. Каждый раз, когда пользователь входит в систему, таймер сбрасывается. Значение нуля указывает, что таймер подключения отключен.
TimeoutSettingsDisconnections
Максимальная длительность (в миллисекундах), которую сервер сохраняет отключенный сеанс до завершения входа. Значение нуля указывает, что таймер отключения отключен.
TimeoutSettingsIdle
Время в миллисекундах, которое подключение может оставаться бездействующим. Если на этот период времени нет действия клавиатуры или мыши, сервер принимает действие, указанное элементом BrokenTimeoutSettings. Значение нуля указывает, что таймер простоя отключен.
DeviceClientDrives
Этот элемент зарезервирован.
DeviceClientPrinters
Значение, указывающее, автоматически ли сервер подключается к ранее сопоставленным клиентским принтерам при входе пользователя на сервер. Этот элемент может быть одним из следующих значений.
0
Сервер не подключается к ранее сопоставленным клиентским принтерам.
1
Сервер автоматически подключается к ранее сопоставленным клиентским принтерам.
ClientDefaultPrinter
Значение, указывающее, является ли клиентский принтер принтером по умолчанию. Этот элемент может быть одним из следующих значений.
0
Клиентский принтер не является принтером по умолчанию.
1
Клиентский принтер — это принтер по умолчанию.
BrokenTimeoutSettings
Действие, выполняемое сервером при истечении срока действия таймеров подключения или простоя, или при потере соединения из-за ошибки подключения. Этот элемент может быть одним из следующих значений.
0
Сеанс отключен, но он остается на сервере.
1
Сеанс завершается.
ReconnectSettings
Значение, указывающее, как можно повторно подключить отключенный сеанс для этого пользователя. Этот элемент может быть одним из следующих значений.
0
Пользователь может войти на любой клиентский компьютер, чтобы повторно подключиться к отключенном сеансу.
1
Пользователь должен войти на клиентский компьютер, который изначально использовался для установки отключенного сеанса. Если пользователь входит на другой клиентский компьютер, пользователь получает новый сеанс.
ShadowingSettings
Параметр удаленного управления. Удаленное управление позволяет пользователю удаленно отслеживать операции на экране другого пользователя. Этот элемент может быть одним из следующих значений.
0
Удаленный элемент управления отключен.
1
Пользователь удаленного управления имеет полный контроль над сеансом пользователя с разрешением пользователя.
2
Пользователь удаленного управления имеет полный контроль над сеансом пользователя; Разрешение пользователя не требуется.
3
Пользователь удаленного управления может удаленно просматривать сеанс с разрешением пользователя; Удаленный пользователь не может активно управлять сеансом.
4
Пользователь удаленного управления может удаленно просматривать сеанс, но не активно контролировать сеанс; Разрешение пользователя не требуется.
TerminalServerRemoteHomeDir
Значение, указывающее, содержит ли элемент TerminalServerHomeDir путь к локальному каталогу или сетевому ресурсу. Этот элемент нельзя задать с помощью функции WTSSetUserConfig. Этот элемент может быть одним из следующих значений.
0
Элемент TerminalServerHomeDir содержит путь к локальному каталогу.
1
Элемент TerminalServerHomeDir содержит путь к сетевой папке, а член TerminalServerHomeDirDrive содержит букву диска, с которой сопоставляется этот путь.
InitialProgram[MAX_PATH + 1]
Строка, завершающаяся значением NULL, содержащая имя программы, которая запускается сразу после входа пользователя на сервер.
WorkDirectory[MAX_PATH + 1]
Строка, завершающая значение NULL, содержащая путь к рабочему каталогу для начальной программы.
TerminalServerProfilePath[MAX_PATH + 1]
Строка, завершающая значение NULL, содержащая путь профиля, назначенный пользователю при подключении пользователя к серверу. Каталог, указанный путем, должен быть создан вручную и должен существовать до входа.
TerminalServerHomeDir[MAX_PATH + 1]
Строка, завершающая значение NULL, содержащая путь к домашней папке сеансов служб удаленных рабочих столов пользователя. Папка может быть локальной папкой или сетевой папкой.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Строка, завершающая значение NULL, содержащая имя диска (буква диска, за которой следует двоеточие), с которой сопоставляется путь, указанный в элементе TerminalServerHomeDir. Этот элемент действителен только в том случае, если для элемента TerminalServerRemoteHomeDir задано значение одного.
Замечания
Заметка
Заголовок wtsapi32.h определяет WTSUSERCONFIG как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 7 |
| минимальный поддерживаемый сервер | Windows Server 2008 R2 |
| заголовка | wtsapi32.h |