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 標頭會根據 UNICODE 預處理器常數的定義，將 WTSLISTENERCONFIG 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 7
支援的最低伺服器	Windows Server 2008 R2
標頭	wtsapi32.h

另請參閱

WTSCreateListener