WTS_SESSION_INFO_1A-Struktur (wtsapi32.h)

  • Artikel

Enthält erweiterte Informationen zu einer Clientsitzung auf einem Remotedesktopsitzungshostserver (RD-Sitzungshost) oder einem Remotedesktopvirtualisierungshostserver (RD Virtualization Host).

Syntax

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;

Member

ExecEnvId

Ein Bezeichner, der die Sitzung in der Liste der von der WTSEnumerateSessionsEx-Funktion zurückgegebenen Sitzungen eindeutig identifiziert. Weitere Informationen finden Sie in den Hinweisen.

State

Ein Wert des WTS_CONNECTSTATE_CLASS Enumerationstyps, der den Verbindungsstatus einer Remotedesktopdienste-Sitzung angibt.

SessionId

Ein Sitzungsbezeichner, der vom RD-Sitzungshostserver, dem RD-Virtualisierungshostserver oder dem virtuellen Computer zugewiesen wird.

pSessionName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen dieser Sitzung enthält. Beispiel: "services", "console" oder "RDP-Tcp#0".

pHostName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Computers enthält, auf dem die Sitzung ausgeführt wird. Wenn die Sitzung direkt auf einem RD-Sitzungshostserver oder einem RD-Virtualisierungshostserver ausgeführt wird, enthält die Zeichenfolge NULL. Wenn die Sitzung auf einem virtuellen Computer ausgeführt wird, enthält die Zeichenfolge den Namen des virtuellen Computers.

pUserName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Benutzers enthält, der bei der Sitzung angemeldet ist. Wenn kein Benutzer bei der Sitzung angemeldet ist, enthält die Zeichenfolge NULL.

pDomainName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Domänennamen des Benutzers enthält, der bei der Sitzung angemeldet ist. Wenn kein Benutzer bei der Sitzung angemeldet ist, enthält die Zeichenfolge NULL.

pFarmName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen der Farm enthält, in die der virtuelle Computer eingebunden ist. Wenn die Sitzung nicht auf einem virtuellen Computer ausgeführt wird, der mit einer Farm verbunden ist, enthält die Zeichenfolge NULL.

Hinweise

Die WTSEnumerateSessionsEx-Funktion gibt diese Struktur zurück, wenn Sie die Funktion aufrufen und ein Handle für einen RD-Virtualisierungshostserver angeben, den Sie durch Aufrufen der FUNKTION WTSOpenServerEx erhalten haben. In diesem Fall aggregiert die WTSEnumerateSessionsEx-Funktion alle Sitzungen, die auf dem Host selbst ausgeführt werden, sowie Sitzungen, die auf einzelnen virtuellen Computern ausgeführt werden. Der ExecEnvId-Parameter identifiziert jede Sitzung in der aggregierten Liste eindeutig. Dieser Bezeichner kann sich von dem tatsächlichen Sitzungsbezeichner unterscheiden, der auf dem Server oder dem virtuellen Computer, der die Sitzung hostet, definiert ist, was vom SessionId-Element angegeben wird.

Die durch diese Struktur dargestellte Sitzung kann eine Sitzung sein, die direkt auf dem Server ausgeführt wird, oder eine Sitzung, die auf einem virtuellen Computer ausgeführt wird. Wenn die Sitzung auf einem virtuellen Computer ausgeführt wird, enthält das pHostName-Element den Namen des virtuellen Computers. Das pFarmName-Element gilt für Sitzungen, die auf virtuellen Computern gehostet werden, die einer RD-Sitzungshostfarm hinzugefügt sind.

Hinweis

Der wtsapi32.h-Header definiert WTS_SESSION_INFO_1 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Kopfzeile wtsapi32.h

Weitere Informationen

WTSEnumerateSessionsEx

WTS_SESSION_INFO