Структура WTSUSERCONFIGW (wtsapi32.h)
Содержит сведения о конфигурации пользователя на контроллере домена или сервере узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов). Эта структура используется функциями WTSQueryUserConfig и WTSSetUserConfig .
Синтаксис
typedef struct _WTSUSERCONFIGW {
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;
WCHAR InitialProgram[MAX_PATH + 1];
WCHAR WorkDirectory[MAX_PATH + 1];
WCHAR TerminalServerProfilePath[MAX_PATH + 1];
WCHAR TerminalServerHomeDir[MAX_PATH + 1];
WCHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGW, *PWTSUSERCONFIGW;
Члены
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]
Строка с пустым завершением, содержащая путь к домашней папке сеансов служб удаленных рабочих столов пользователя. Это может быть локальная папка или сетевая папка.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Строка, завершающаяся значением NULL, содержащая имя диска (буква диска, за которой следует двоеточие), с которым сопоставлен путь, указанный в элементе TerminalServerHomeDir . Этот элемент действителен, только если для элемента TerminalServerRemoteHomeDir задано значение .
Комментарии
Примечание
Заголовок wtsapi32.h определяет WTSUSERCONFIG как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 7 |
| Минимальная версия сервера | Windows Server 2008 R2 |
| Верхняя часть | wtsapi32.h |