WTS_SESSION_INFO_1A-Struktur (wtsapi32.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für