WTSUSERCONFIGA 結構 (wtsapi32.h)

包含網域控制站或遠端桌面工作階段主機 (RD 工作階段主機) 伺服器上的使用者的組態資訊。 WTSQueryUserConfig和WTSSetUserConfig函式會使用此結構。

語法

typedef struct _WTSUSERCONFIGA {
  DWORD Source;
  DWORD InheritInitialProgram;
  DWORD AllowLogonTerminalServer;
  DWORD TimeoutSettingsConnections;
  DWORD TimeoutSettingsDisconnections;
  DWORD TimeoutSettingsIdle;
  DWORD DeviceClientDrives;
  DWORD DeviceClientPrinters;
  DWORD ClientDefaultPrinter;
  DWORD BrokenTimeoutSettings;
  DWORD ReconnectSettings;
  DWORD ShadowingSettings;
  DWORD TerminalServerRemoteHomeDir;
  CHAR  InitialProgram[MAX_PATH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  TerminalServerProfilePath[MAX_PATH + 1];
  CHAR  TerminalServerHomeDir[MAX_PATH + 1];
  CHAR  TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;

成員

Source

WTS_CONFIG_SOURCE列舉類型的值，指定WTSQueryUserConfig函式所傳回的組態資訊來源。

InheritInitialProgram

值，指出用戶端是否可以指定初始程式。 這個成員可以是下列其中一個值。

0

用戶端無法指定初始程式。 相反地，當使用者登入伺服器時， InitialProgram 成員指定的程式會自動啟動。 當使用者結束該程式時，伺服器會將使用者登出。

1

用戶端可以指定初始程式。

AllowLogonTerminalServer

值，指出是否允許使用者帳戶登入 RD 工作階段主機伺服器。 這個成員可以是下列其中一個值。

0

使用者無法登入。

1

使用者可以登入。

TimeoutSettingsConnections

連接持續時間上限，以毫秒為單位。 連線到期前的一分鐘，伺服器會通知使用者擱置中斷連線。 當連線逾時時，伺服器會採取 BrokenTimeoutSettings 成員所指定的動作。 每次使用者登入時，都會重設計時器。 值為零表示已停用連接計時器。

TimeoutSettingsDisconnections

伺服器在登入終止之前保留中斷連線會話的最大持續時間，以毫秒為單位。 值為零表示中斷連線計時器已停用。

TimeoutSettingsIdle

連接可以維持閒置的時間量，以毫秒為單位。 如果這段時間沒有鍵盤或滑鼠活動，伺服器會採取 BrokenTimeoutSettings 成員所指定的動作。 值為零表示閒置計時器已停用。

DeviceClientDrives

此成員已保留。

DeviceClientPrinters

值，指出當使用者登入伺服器時，伺服器是否自動連接到先前對應的用戶端印表機。 這個成員可以是下列其中一個值。

0

伺服器不會自動連線到先前對應的用戶端印表機。

1

伺服器會自動連線到先前對應的用戶端印表機。

ClientDefaultPrinter

值，指出用戶端印表機是否為預設印表機。 這個成員可以是下列其中一個值。

0

用戶端印表機不是預設印表機。

1

用戶端印表機是預設印表機。

BrokenTimeoutSettings

當連線或閒置計時器過期，或連線因為連線錯誤而遺失時，伺服器所採取的動作。 這個成員可以是下列其中一個值。

0

會話已中斷連線，但會保留在伺服器上。

1

會話已終止。

ReconnectSettings

值，指出如何重新連線此使用者的中斷連線會話。 這個成員可以是下列其中一個值。

0

使用者可以登入任何用戶端電腦，以重新連線到已中斷連線的會話。

1

使用者必須登入原本用來建立已中斷連線會話的用戶端電腦。 如果使用者登入不同的用戶端電腦，使用者就會取得新的會話。

ShadowingSettings

遠端控制設定。 遠端控制可讓使用者從遠端監視其他使用者的螢幕操作。 這個成員可以是下列其中一個值。

0

遠端控制已停用。

1

遠端控制的使用者擁有使用者會話的完整控制權，並具有使用者的許可權。

2

遠端控制的使用者具有使用者會話的完整控制權;不需要使用者的許可權。

3

遠端控制的使用者可以使用使用者的許可權，從遠端檢視會話;遠端使用者無法主動控制會話。

4

遠端控制的使用者可以從遠端檢視會話，但無法主動控制會話;不需要使用者的許可權。

TerminalServerRemoteHomeDir

值，指出 TerminalServerHomeDir 成員是否包含本機目錄或網路共用的路徑。 您無法使用 WTSSetUserConfig 函式來設定此成員。 這個成員可以是下列其中一個值。

0

TerminalServerHomeDir成員包含本機目錄的路徑。

1

TerminalServerHomeDir成員包含網路共用的路徑，而 TerminalServerHomeDirDrive成員包含此路徑對應的磁碟機號。

InitialProgram[MAX_PATH + 1]

以 Null 結尾的字串，其中包含使用者登入伺服器之後要立即啟動的程式名稱。

WorkDirectory[MAX_PATH + 1]

以 Null 結束的字串，其中包含初始程式的工作目錄路徑。

TerminalServerProfilePath[MAX_PATH + 1]

以 Null 結束的字串，其中包含使用者連線到伺服器時指派給使用者的設定檔路徑。 路徑指定的目錄必須手動建立，而且必須在登入之前存在。

TerminalServerHomeDir[MAX_PATH + 1]

以 Null 結尾的字串，其中包含使用者遠端桌面服務會話主資料夾的路徑。 資料夾可以是本機資料夾或網路共用。

TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]

以 Null 結尾的字串，其中包含磁碟機號 (磁碟機號後面接著冒號) 終端機ServerHomeDir 成員中所指定路徑的對應。 只有當 TerminalServerRemoteHomeDir 成員設定為一個時，這個成員才有效。

備註

規格需求

另請參閱

WTSQueryUserConfig

WTSSetUserConfig

WTS_CONFIG_SOURCE