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

指定是否禁用即插即用重定向。 此成员可以是以下值之一。

0

用户可以启用即插即用重定向。

1

即插即用重定向已禁用。

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) 加密算法和 Microsoft 加密模块对从客户端发送到服务器以及从服务器发送到客户端的所有数据进行加密和解密。

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 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 7
最低受支持的服务器	Windows Server 2008 R2
标头	wtsapi32.h

另请参阅

WTSCreateListener