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 成員設定為一個時,這個成員才有效。
備註
注意
wtsapi32.h 標頭會將 WTSUSERCONFIG 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 7 |
最低支援的伺服器 | Windows Server 2008 R2 |
標頭 | wtsapi32.h |