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。
備註
如果您呼叫 函式並指定 RD 虛擬化主機伺服器的控制碼，WTSEnumerateSessionsEx函式會傳回這個結構。 在此情況下， WTSEnumerateSessionsEx 函式會匯總主機上執行的所有會話，以及個別虛擬機器上執行的會話。 ExecEnvId參數可唯一識別匯總清單中的每個會話。 此識別碼可能與裝載會話之伺服器或虛擬機器中定義的實際會話識別碼不同，此識別碼是由 SessionId 成員所指定。
此結構所代表的會話可能是直接在伺服器上執行的會話，或是在虛擬機器內執行的會話。 如果會話在虛擬機器內執行， pHostName 成員會包含虛擬機器的名稱。 pFarmName成員適用于裝載于已加入 RD 工作階段主機伺服器陣列之虛擬機器上的會話。
注意
wtsapi32.h 標頭會將WTS_SESSION_INFO_1定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows 7 |
| 最低支援的伺服器 | Windows Server 2008 R2 |
| 標頭 | wtsapi32.h |