WTS_INFO_CLASS列舉 (wtsapi32.h)

包含值,指出呼叫 WTSQuerySessionInformation 函式時要擷取的會話資訊類型。

Syntax

typedef enum _WTS_INFO_CLASS {
  WTSInitialProgram,
  WTSApplicationName,
  WTSWorkingDirectory,
  WTSOEMId,
  WTSSessionId,
  WTSUserName,
  WTSWinStationName,
  WTSDomainName,
  WTSConnectState,
  WTSClientBuildNumber,
  WTSClientName,
  WTSClientDirectory,
  WTSClientProductId,
  WTSClientHardwareId,
  WTSClientAddress,
  WTSClientDisplay,
  WTSClientProtocolType,
  WTSIdleTime,
  WTSLogonTime,
  WTSIncomingBytes,
  WTSOutgoingBytes,
  WTSIncomingFrames,
  WTSOutgoingFrames,
  WTSClientInfo,
  WTSSessionInfo,
  WTSSessionInfoEx,
  WTSConfigInfo,
  WTSValidationInfo,
  WTSSessionAddressV4,
  WTSIsRemoteSession
} WTS_INFO_CLASS;

常數

 
WTSInitialProgram
以 Null 結尾的字串,其中包含遠端桌面服務在 執行時的初始程式名稱
使用者登入。
WTSApplicationName
以 Null 結尾的字串,其中包含會話正在執行之應用程式的已發佈名稱。

Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista: 不支援此值
WTSWorkingDirectory
Null 終止的字串,包含啟動初始程式時所使用的預設目錄。
WTSOEMId
不使用這個值。
WTSSessionId
包含會話識別碼的 ULONG 值。
WTSUserName
以 Null 結尾的字串,其中包含與會話相關聯的使用者名稱。
WTSWinStationName
包含遠端桌面服務會話名稱的 Null 終止字串。

注意 儘管其名稱,但指定此類型不會傳回視窗月臺名稱。 相反地,它會傳回
遠端桌面服務會話的名稱。 每個遠端桌面服務會話都與互動式視窗相關聯
站。 因為互動式視窗月臺唯一支援的視窗月臺名稱是
「WinSta0」,每個會話都會與其自己的 「WinSta0」 視窗站相關聯。 如需相關資訊,請參閱
視窗站台。

 
WTSDomainName
以 Null 結尾的字串,其中包含登入使用者所屬的功能變數名稱。
WTSConnectState
會話目前的線上狀態。 如需相關資訊,請參閱
WTS_CONNECTSTATE_CLASS
WTSClientBuildNumber
包含用戶端組建編號的 ULONG 值。
WTSClientName
包含用戶端名稱的 Null 終止字串。
WTSClientDirectory
以 Null 結束的字串,其中包含安裝用戶端的目錄。
WTSClientProductId
USHORT用戶端特定產品識別碼。
WTSClientHardwareId
包含用戶端特定硬體識別碼的 ULONG 值。 此選項保留供日後使用。 WTSQuerySessionInformation 一律會傳回 0 的值。
WTSClientAddress
用戶端的網路類型和網路位址。 如需相關資訊,請參閱
WTS_CLIENT_ADDRESS

IP 位址會從WTS_CLIENT_ADDRESS位址成員開頭位移兩個位元組
結構。
WTSClientDisplay
用戶端顯示解析度的相關資訊。 如需相關資訊,請參閱
WTS_CLIENT_DISPLAY
WTSClientProtocolType
USHORT值,指定 的通訊協定類型相關資訊
會話。 這是下列其中一個值。


















意義

0


主控台會話。


1


此值會保留為舊版用途。


2


RDP 通訊協定。

WTSIdleTime
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

若要推斷會話閒置時間,請使用 LastInputTime 結構欄位。

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSLogonTime
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSIncomingBytes
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSOutgoingBytes
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSIncomingFrames
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSOutgoingFrames
這個值會傳回 FALSE。 如果您呼叫 GetLastError 以取得延伸的錯誤資訊, GetLastError 會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不使用這個值。
WTSClientInfo
遠端桌面連線 (RDC) 用戶端的相關資訊。 如需詳細資訊,請參閱 WTSCLIENT
WTSSessionInfo
RD 工作階段主機伺服器上的用戶端會話相關資訊。 如需詳細資訊,請參閱 WTSINFO
WTSSessionInfoEx
RD 工作階段主機伺服器上的會話擴充資訊。 如需詳細資訊,請參閱 WTSINFOEX

Windows Server 2008 和 Windows Vista: 不支援此值。
WTSConfigInfo
包含 RD 工作階段主機伺服器設定相關資訊的 WTSCONFIGINFO 結構。

Windows Server 2008 和 Windows Vista: 不支援此值。
WTSValidationInfo
不支援此值。
WTSSessionAddressV4
包含指派給會話之 IPv4 位址 的WTS_SESSION_ADDRESS 結構。
如果會話沒有虛擬 IP 位址, WTSQuerySessionInformation 函式會傳回 ERROR_NOT_SUPPORTED

Windows Server 2008 和 Windows Vista: 不支援此值。
WTSIsRemoteSession
判斷目前的會話是否為遠端會話。 WTSQuerySessionInformation函式會傳回TRUE值,指出目前的會話是遠端會話,而 FALSE表示目前的會話是本機會話。 此值只能用於本機電腦,因此WTSQuerySessionInformation函式的hServer參數必須包含WTS_CURRENT_SERVER_HANDLE

Windows Server 2008 和 Windows Vista: 不支援此值。

規格需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 wtsapi32.h

另請參閱

WTSQuerySessionInformation