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

Содержит сведения о прослушивателе Служб удаленных рабочих столов. Эта структура используется функцией 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