WTS_SESSION_INFO_1A結構 (wtsapi32.h)
包含遠端桌面工作階段主機 (RD 工作階段主機) 伺服器或遠端桌面虛擬化主機 (RD 虛擬化主機) 伺服器上用戶端工作階段的擴充資訊。
語法
typedef struct _WTS_SESSION_INFO_1A {
DWORD ExecEnvId;
WTS_CONNECTSTATE_CLASS State;
DWORD SessionId;
LPSTR pSessionName;
LPSTR pHostName;
LPSTR pUserName;
LPSTR pDomainName;
LPSTR pFarmName;
} WTS_SESSION_INFO_1A, *PWTS_SESSION_INFO_1A;
成員
ExecEnvId
標識符,可唯一識別 WTSEnumerateSessionsEx 函式所傳回之會話清單中的會話。 如需詳細資訊,請參閱。
State
指定遠端桌面服務會話連接狀態之 WTS_CONNECTSTATE_CLASS 列舉型別的值。
SessionId
RD 會話主機伺服器、RD 虛擬化主機伺服器或虛擬機所指派的會話標識碼。
pSessionName
包含此工作階段名稱之 Null 終止字串的指標。 例如,“services”、“console” 或 “RDP-Tcp#0”。
pHostName
Null 終止字串的指標,其中包含會話執行的計算機名稱。 如果工作階段直接在 RD 工作階段主機伺服器或 RD 虛擬化主機伺服器上執行,字串會包含 NULL。 如果會話在虛擬機上執行,字串會包含虛擬機的名稱。
pUserName
Null 終止字串的指標,其中包含登入工作階段的用戶名稱。 如果沒有使用者登入工作階段,字串會包含 null 。
pDomainName
Null 終止字串的指標,其中包含登入會話之使用者的功能變數名稱。 如果沒有使用者登入工作階段,字串會包含 null 。
pFarmName
Null 終止字串的指標,其中包含虛擬機加入之伺服器陣列的名稱。 如果工作階段未在加入伺服器陣列的虛擬機上執行,字串會包含 null 。
言論
WTSEnumerateSessionsEx 函式會傳回此結構,如果您呼叫 函式並指定 RD 虛擬化主機伺服器的句柄,則呼叫 WTSOpenServerEx 函式取得。 在此情況下,WTSEnumerateSessionsEx 函式會匯總主機上執行的所有會話,以及個別虛擬機上執行的會話。 ExecEnvId 參數可唯一識別匯總清單中的每個會話。 此標識符可能與裝載會話的伺服器或虛擬機中定義的實際會話標識碼不同,而該會話是由 SessionId 成員所指定。
此結構所代表的會話可以是直接在伺服器上執行的會話,或是在虛擬機內執行的會話。 如果會話是在虛擬機內執行,pHostName 成員會包含虛擬機的名稱。 pFarmName 成員適用於裝載於已加入 RD 工作階段主機陣列之虛擬機上的作業階段。
注意
wtsapi32.h 標頭會將WTS_SESSION_INFO_1定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 7 |
支援的最低伺服器 | Windows Server 2008 R2 |
標頭 | wtsapi32.h |