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

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

Синтаксис

typedef struct _WTSLISTENERCONFIGA {
  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;
  CHAR  Comment[WTS_COMMENT_LENGTH + 1];
  CHAR  LogonUserName[USERNAME_LENGTH + 1];
  CHAR  LogonDomain[DOMAIN_LENGTH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;

Члены

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]

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

LogonUserName[USERNAME_LENGTH + 1]

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

LogonDomain[DOMAIN_LENGTH + 1]

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

WorkDirectory[MAX_PATH + 1]

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

InitialProgram[MAX_PATH + 1]

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

Комментарии

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Верхняя часть	wtsapi32.h

См. также раздел

WTSCreateListener