WTS_SESSION_INFO_1A Struktur (wtsapi32.h)
Enthält erweiterte Informationen zu einer Clientsitzung auf einem RD-Sitzungshost-Server (RD-Sitzungshost) oder remotedesktopvirtualisierungshost (RD Virtualization Host)-Server.
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;
Angehörige
ExecEnvId
Ein Bezeichner, der die Sitzung innerhalb der Liste der Sitzungen identifiziert, die von der funktion WTSEnumerateSessionsEx zurückgegeben werden. 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 mit Null beendete Zeichenfolge, die den Namen dieser Sitzung enthält. Beispiel: "Services", "console" oder "RDP-Tcp#0".
pHostName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Computers enthält, auf dem die Sitzung ausgeführt wird. Wenn die Sitzung direkt auf einem RD-Sitzungshostserver oder RD Virtualization Host-Server 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 mit Null beendete 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 mit Null beendete 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 mit Null beendete Zeichenfolge, die den Namen der Farm enthält, mit der der virtuelle Computer verbunden ist. Wenn die Sitzung nicht auf einem virtuellen Computer ausgeführt wird, der einer Farm beigetreten ist, enthält die Zeichenfolge NULL-.
Bemerkungen
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 WTSOpenServerEx--Funktion erhalten haben. In diesem Fall aggregiert die funktion WTSEnumerateSessionsEx alle Sitzungen, die auf dem Host selbst ausgeführt werden, sowie Sitzungen, die auf einzelnen virtuellen Computern ausgeführt werden. Der parameter ExecEnvId identifiziert jede Sitzung in der aggregierten Liste eindeutig. Dieser Bezeichner kann sich von dem tatsächlichen Sitzungsbezeichner unterscheiden, der auf dem Server oder virtuellen Computer definiert ist, der die Sitzung hostt, die durch die SessionId Member angegeben wird.
Die durch diese Struktur dargestellte Sitzung kann eine Sitzung sein, die direkt auf dem Server oder in einer Sitzung ausgeführt wird, die auf einem virtuellen Computer ausgeführt wird. Wenn die Sitzung auf einem virtuellen Computer ausgeführt wird, enthält das pHostName Member den Namen des virtuellen Computers. Das pFarmName Mitglieds gilt für Sitzungen, die auf virtuellen Computern gehostet werden, die einer RD-Sitzungshostfarm beigetreten sind.
Anmerkung
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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| mindestens unterstützte Server- | Windows Server 2008 R2 |
| Header- | wtsapi32.h |