WTSUSERCONFIGW 結構 （wtsapi32.h）
包含域控制器或遠端桌面會話主機 （RD 工作階段主機） 伺服器上的使用者的組態資訊。 WTSQueryUserConfig 和 WTSSetUserConfig 函式會使用此結構。
語法
typedef struct _WTSUSERCONFIGW {
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;
WCHAR InitialProgram[MAX_PATH + 1];
WCHAR WorkDirectory[MAX_PATH + 1];
WCHAR TerminalServerProfilePath[MAX_PATH + 1];
WCHAR TerminalServerHomeDir[MAX_PATH + 1];
WCHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGW, *PWTSUSERCONFIGW;
成員
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 結尾的字串，其中包含磁碟驅動器名稱（驅動器號後面接著冒號），TerminalServerHomeDir 成員中指定的路徑。 只有當 TerminalServerRemoteHomeDir 成員設定為一個時，這個成員才有效。
言論
注意
wtsapi32.h 標頭會將 WTSUSERCONFIG 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 7 |
| 支援的最低伺服器 | Windows Server 2008 R2 |
| 標頭 | wtsapi32.h |