Структура WTSLISTENERCONFIGW (wtsapi32.h)

Статья
08/28/2023

Содержит сведения о прослушивателе служб удаленных рабочих столов. Эта структура используется функцией WTSCreateListener.

Синтаксис

typedef struct _WTSLISTENERCONFIGW {
  ULONG version;
  ULONG fEnableListener;
  ULONG MaxConnectionCount;
  ULONG fPromptForPassword;
  ULONG fInheritColorDepth;
  ULONG ColorDepth;
  ULONG fInheritBrokenTimeoutSettings;
  ULONG BrokenTimeoutSettings;
  ULONG fDisablePrinterRedirection;
  ULONG fDisableDriveRedirection;
  ULONG fDisableComPortRedirection;
  ULONG fDisableLPTPortRedirection;
  ULONG fDisableClipboardRedirection;
  ULONG fDisableAudioRedirection;
  ULONG fDisablePNPRedirection;
  ULONG fDisableDefaultMainClientPrinter;
  ULONG LanAdapter;
  ULONG PortNumber;
  ULONG fInheritShadowSettings;
  ULONG ShadowSettings;
  ULONG TimeoutSettingsConnection;
  ULONG TimeoutSettingsDisconnection;
  ULONG TimeoutSettingsIdle;
  ULONG SecurityLayer;
  ULONG MinEncryptionLevel;
  ULONG UserAuthentication;
  WCHAR Comment[WTS_COMMENT_LENGTH + 1];
  WCHAR LogonUserName[USERNAME_LENGTH + 1];
  WCHAR LogonDomain[DOMAIN_LENGTH + 1];
  WCHAR WorkDirectory[MAX_PATH + 1];
  WCHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGW, *PWTSLISTENERCONFIGW;

Члены

version

Этот элемент зарезервирован.

fEnableListener

Указывает, включен ли прослушиватель. Этот элемент может быть одним из следующих значений.

0

Прослушиватель отключен.

1

Прослушиватель включен.

MaxConnectionCount

Максимальное количество активных подключений, которые принимает прослушиватель.

fPromptForPassword

Указывает, всегда ли прослушиватель запрашивает у пользователя пароль. Этот элемент может быть одним из следующих значений.

0

Запрос пользователя на ввод пароля только в том случае, если он указан сервером.

1

Всегда запрашивайте у пользователя пароль.

fInheritColorDepth

Указывает, должен ли прослушиватель использовать цветовую глубину, указанную пользователем. Этот элемент может быть одним из следующих значений.

0

Используйте глубину цвета, указанную сервером.

1

Используйте глубину цвета, указанную пользователем.

ColorDepth

Параметр глубины цвета прослушивателя. Этот параметр применяется только в том случае, если элемент fInheritColorDepth равен нулю. Это может быть одно из следующих значений.

1

8 бит

2

15-разрядная версия

3

16-разрядный

4

24-разрядная версия

5

32-разрядная версия

fInheritBrokenTimeoutSettings

Указывает, должен ли прослушиватель использовать значение BrokenTimeoutSettings, указанное пользователем. Этот элемент может быть одним из следующих значений.

0

Используйте значение BrokenTimeoutSettings, указанное сервером.

1

Используйте значение BrokenTimeoutSettings, указанное пользователем.

BrokenTimeoutSettings

Действие, которое прослушиватель принимает, когда истекает срок действия соединения или таймера простоя или когда соединение потеряно из-за ошибки подключения. Этот параметр применяется только в том случае, если элемент fInheritBrokenTimeoutSettings равно нулю. Этот элемент может быть одним из следующих значений.

0

Когда истекает срок действия подключения или таймер простоя или когда соединение потеряно из-за ошибки подключения, пользователь отключается, но сеанс остается на сервере.

1

Когда истекает срок действия подключения или таймер простоя или когда соединение потеряно из-за ошибки подключения, сеанс завершается.

fDisablePrinterRedirection

Указывает, отключен ли перенаправление принтера. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление принтера.

1

Перенаправление принтера отключено.

fDisableDriveRedirection

Указывает, отключена ли перенаправление диска. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление дисков.

1

Перенаправление диска отключено.

fDisableComPortRedirection

Указывает, отключен ли перенаправление портов COM. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление портов COM.

1

Перенаправление портов COM отключено.

fDisableLPTPortRedirection

Указывает, отключен ли перенаправление портов LPT. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление портов LPT.

1

Перенаправление портов LPT отключено.

fDisableClipboardRedirection

Указывает, отключена ли перенаправление буфера обмена. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление буфера обмена.

1

Перенаправление буфера обмена отключено.

fDisableAudioRedirection

Указывает, отключена ли перенаправление звука. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление звука.

1

Перенаправление звука отключено.

fDisablePNPRedirection

Указывает, отключена ли перенаправление Plug and Play. Этот элемент может быть одним из следующих значений.

0

Пользователь может включить перенаправление Plug and Play.

1

Перенаправление Plug and Play отключено.

fDisableDefaultMainClientPrinter

Указывает, является ли клиентский принтер принтером по умолчанию. Этот элемент может быть одним из следующих значений.

0

Клиентский принтер не является принтером по умолчанию.

1

Клиентский принтер — это принтер по умолчанию.

LanAdapter

Сетевой адаптер, который использует прослушиватель.

PortNumber

Номер порта прослушивателя.

fInheritShadowSettings

Указывает, должен ли прослушиватель использовать значение ShadowSettings, указанное пользователем. Этот элемент может быть одним из следующих значений.

0

Используйте параметр, указанный сервером.

1

Используйте параметр, указанный пользователем.

ShadowSettings

Параметр удаленного управления для прослушивателя. Удаленное управление позволяет пользователю удаленно отслеживать операции на экране другого пользователя. Этот параметр применяется только в том случае, если элемент fInheritShadowSettings равно нулю. Этот элемент может быть одним из следующих значений.

0

Удаленный элемент управления отключен.

1

Пользователь удаленного управления имеет полный контроль над сеансом пользователя с разрешением пользователя.

2

Пользователь удаленного управления имеет полный контроль над сеансом пользователя; Разрешение пользователя не требуется.

3

Пользователь удаленного управления может удаленно просматривать сеанс с разрешением пользователя; Удаленный пользователь не может активно управлять сеансом.

4

Пользователь удаленного управления может удаленно просматривать сеанс, но не активно контролировать сеанс; Разрешение пользователя не требуется.

TimeoutSettingsConnection

Максимальная длительность подключения в миллисекундах. Каждый раз, когда пользователь входит в систему, таймер сбрасывается. Значение нуля указывает, что таймер подключения отключен.

TimeoutSettingsDisconnection

Максимальная продолжительность в миллисекундах, которую сервер сохраняет отключенный сеанс до завершения входа. Значение нуля указывает, что таймер отключения отключен.

TimeoutSettingsIdle

Максимальное время простоя в миллисекундах. Значение нуля указывает, что таймер простоя отключен.

SecurityLayer

Уровень безопасности прослушивателя. Этот элемент может быть одним из следующих значений.

0

Протокол удаленного рабочего стола (RDP) используется сервером и клиентом для проверки подлинности до установки подключения.

1

Сервер и клиент согласовывают метод проверки подлинности до установки подключения.

2

Протокол TLS используется сервером и клиентом для проверки подлинности до установки подключения.

MinEncryptionLevel

Уровень шифрования прослушивателя. Этот элемент может быть одним из следующих значений.

1

Данные, отправляемые клиентом на сервер, шифруются с помощью 56-разрядного шифрования. Данные, отправляемые с сервера клиенту, не шифруются.

2

Все данные, отправляемые клиентом на сервер и с сервера на клиент, шифруются с помощью максимальной силы ключа, поддерживаемой клиентом.

3

Все данные, отправляемые клиентом на сервер и с сервера на клиент, шифруются с помощью 128-разрядного шифрования. Клиенты, которые не поддерживают этот уровень шифрования, не могут подключаться.

4

Все данные, отправляемые клиентом на сервер и с сервера на клиент, шифруются и расшифровываются с помощью алгоритмов шифрования федеральных стандартов обработки информации (FIPS) и криптографических модулей Майкрософт.

UserAuthentication

Указывает, требуется ли проверка подлинности пользователя на уровне сети перед созданием подключения. Этот элемент может быть одним из следующих значений.

0

Проверка подлинности пользователя на уровне сети не требуется.

1

Требуется проверка подлинности пользователя на уровне сети.

Comment[WTS_COMMENT_LENGTH + 1]

Строка, завершающаяся значением NULL, содержащая описание прослушивателя.

LogonUserName[USERNAME_LENGTH + 1]

Строка, завершающая значение NULL, содержащая имя пользователя, используемое в сценариях автоматического входа.

LogonDomain[DOMAIN_LENGTH + 1]

Строка, завершающая значение NULL, содержащая доменное имя, используемое в сценариях автоматического входа.

WorkDirectory[MAX_PATH + 1]

Строка, завершающая значение NULL, содержащая путь к рабочему каталогу начальной программы.

InitialProgram[MAX_PATH + 1]

Строка, завершающаяся значением NULL, содержащая имя программы, которая запускается сразу после входа пользователя на сервер.

Замечания

Заметка

Заголовок wtsapi32.h определяет WTSLISTENERCONFIG как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7
минимальный поддерживаемый сервер	Windows Server 2008 R2
заголовка	wtsapi32.h

См. также

WTSCreateListener

Поделиться через