WTS_INFO_CLASS-Enumeration (wtsapi32.h)

  • Artikel

Enthält Werte, die den Typ der Sitzungsinformationen angeben, die in einem Aufruf der FUNKTION WTSQuerySessionInformation abgerufen werden sollen.

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;

Konstanten

 
WTSInitialProgram
Eine NULL-beendete Zeichenfolge, die den Namen des anfänglichen Programms enthält, das von Remotedesktopdiensten ausgeführt wird, wenn
Benutzer meldet sich an.
WTSApplicationName
Eine NULL-beendete Zeichenfolge, die den veröffentlichten Namen der Anwendung enthält, die von der Sitzung ausgeführt wird.

Windows Server 2008 R2, Windows 7, Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.
WTSWorkingDirectory
Eine NULL-Zeichenfolge, die das Standardverzeichnis enthält, das beim Starten des ersten Programms verwendet wird.
WTSOEMId
Dieser Wert wird nicht verwendet.
WTSSessionId
Ein ULONG-Wert , der den Sitzungsbezeichner enthält.
WTSUserName
Eine NULL-Zeichenfolge, die den Namen des Benutzers enthält, der der Sitzung zugeordnet ist.
WTSWinStationName
Eine NULL-beendete Zeichenfolge, die den Namen der Remotedesktopdienste-Sitzung enthält.

Hinweis Trotz des Namens gibt die Angabe dieses Typs nicht den Namen der Fensterstation zurück. Stattdessen wird die
Name der Remotedesktopdienste-Sitzung. Jede Remotedesktopdienstesitzung ist einem interaktiven Fenster zugeordnet.
Station. Da der einzige unterstützte Fensterstationsname für eine interaktive Fensterstation ist
"WinSta0", jede Sitzung ist einer eigenen Fensterstation "WinSta0" zugeordnet. Weitere Informationen finden Sie unter
Fensterstationen.

 
WTSDomainName
Eine NULL-Zeichenfolge, die den Namen der Domäne enthält, zu der der angemeldete Benutzer gehört.
WTSConnectState
Der aktuelle Verbindungsstatus der Sitzung. Weitere Informationen finden Sie unter
WTS_CONNECTSTATE_CLASS.
WTSClientBuildNumber
Ein ULONG-Wert , der die Buildnummer des Clients enthält.
WTSClientName
Eine NULL-Zeichenfolge, die den Namen des Clients enthält.
WTSClientDirectory
Eine NULL-Zeichenfolge, die das Verzeichnis enthält, in dem der Client installiert ist.
WTSClientProductId
Ein clientspezifischer USHORT-Produktbezeichner .
WTSClientHardwareId
Ein ULONG-Wert , der einen clientspezifischen Hardwarebezeichner enthält. Diese Option ist für die zukünftige Verwendung reserviert. WTSQuerySessionInformation gibt immer den Wert 0 zurück.
WTSClientAddress
Der Netzwerktyp und die Netzwerkadresse des Clients. Weitere Informationen finden Sie unter
WTS_CLIENT_ADDRESS.

Die IP-Adresse wird vom Anfang des Adresselements des WTS_CLIENT_ADDRESS
Struktur.
WTSClientDisplay
Informationen zur Anzeigeauflösung des Clients. Weitere Informationen finden Sie unter
WTS_CLIENT_DISPLAY.
WTSClientProtocolType
Ein USHORT-Wert , der Informationen zum Protokolltyp für den
Sitzung. Dies ist einer der folgenden Werte.


















WertBedeutung

0


Die Konsolensitzung.


1


Dieser Wert wird für Legacyzwecke beibehalten.


2


Das RDP-Protokoll.
WTSIdleTime
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Verwenden Sie das Strukturfeld LastInputTime , um die Leerlaufzeit der Sitzung zu kaculieren.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSLogonTime
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSIncomingBytes
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSOutgoingBytes
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSIncomingFrames
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSOutgoingFrames
Dieser Wert gibt FALSE zurück. Wenn Sie GetLastError aufrufen, um erweiterte Fehlerinformationen abzurufen, gibt GetLastErrorERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht verwendet.
WTSClientInfo
Informationen zu einem RDC-Client (Remotedesktopverbindung). Weitere Informationen finden Sie unter WTSCLIENT.
WTSSessionInfo
Informationen zu einer Clientsitzung auf einem RD-Sitzungshostserver. Weitere Informationen finden Sie unter WTSINFO.
WTSSessionInfoEx
Erweiterte Informationen zu einer Sitzung auf einem RD-Sitzungshostserver. Weitere Informationen finden Sie unter WTSINFOEX.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.
WTSConfigInfo
Eine WTSCONFIGINFO-Struktur , die Informationen zur Konfiguration eines RD-Sitzungshostservers enthält.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.
WTSValidationInfo
Dieser Wert wird nicht unterstützt.
WTSSessionAddressV4
Eine WTS_SESSION_ADDRESS-Struktur , die die der Sitzung zugewiesene IPv4-Adresse enthält.
Wenn die Sitzung keine virtuelle IP-Adresse aufweist, gibt die FUNKTION WTSQuerySessionInformationERROR_NOT_SUPPORTED zurück.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.
WTSIsRemoteSession
Bestimmt, ob es sich bei der aktuellen Sitzung um eine Remotesitzung handelt. Die WTSQuerySessionInformation-Funktion gibt den Wert TRUE zurück, um anzugeben, dass es sich bei der aktuellen Sitzung um eine Remotesitzung handelt, und false , um anzugeben, dass es sich bei der aktuellen Sitzung um eine lokale Sitzung handelt. Dieser Wert kann nur für den lokalen Computer verwendet werden, sodass der hServer-Parameter der FUNKTION WTSQuerySessionInformationWTS_CURRENT_SERVER_HANDLE enthalten muss.

Windows Server 2008 und Windows Vista: Dieser Wert wird nicht unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) WindowsServer 2008
Kopfzeile wtsapi32.h

Weitere Informationen

WTSQuerySessionInformation