WTSEnumerateSessionsA-Funktion (wtsapi32.h)

Ruft eine Liste von Sitzungen auf einem Remotedesktopsitzungshostserver (RD-Sitzungshost) ab.

Syntax

BOOL WTSEnumerateSessionsA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_SESSION_INFOA *ppSessionInfo,
  [out] DWORD              *pCount
);

Parameter

[in] hServer

Ein Handle für den RD-Sitzungshostserver.

Hinweis Sie können die Funktionen WTSOpenServer oder WTSOpenServerEx verwenden, um ein Handle für einen bestimmten Server abzurufen, oder WTS_CURRENT_SERVER_HANDLE , um den RD-Sitzungshostserver zu verwenden, der Ihre Anwendung hostet.
 

[in] Reserved

Dieser Parameter ist reserviert. Sie muss null sein.

[in] Version

Die Version der Enumerationsanforderung. Dieser Parameter muss 1 sein.

[out] ppSessionInfo

Ein Zeiger auf ein Array von WTS_SESSION_INFO Strukturen, die die abgerufenen Sitzungen darstellen. Um den zurückgegebenen Puffer freizugeben, rufen Sie die Funktion WTSFreeMemory auf .

Sitzungsberechtigungen:

  • Um eine Sitzung aufzulisten, müssen Sie die Abfrageinformationsberechtigung aktivieren. Weitere Informationen finden Sie unter Berechtigungen für Remotedesktopdienste.
  • Verwenden Sie zum Ändern der Berechtigungen für eine Sitzung das Verwaltungstool Remotedesktopdienstekonfiguration.
  • Zum Auflisten von Sitzungen, die auf einem virtuellen Computer ausgeführt werden, der auf einem RD-Virtualisierungshostserver gehostet wird, müssen Sie Mitglied der Gruppe Administratoren auf dem RD-Virtualisierungshostserver sein.

[out] pCount

Ein Zeiger auf die Anzahl WTS_SESSION_INFO Strukturen, die im ppSessionInfo-Parameter zurückgegeben werden.

Rückgabewert

Gibt null zurück, wenn diese Funktion fehlschlägt. Wenn diese Funktion erfolgreich ist, wird ein nichtzero-Wert zurückgegeben.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der wtsapi32.h-Header definiert WTSEnumerateSessions als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wtsapi32.h
Bibliothek Wtsapi32.lib
DLL Wtsapi32.dll
APIs ext-ms-win-session-wtsapi32-l1-1-0 (in Windows 8 eingeführt)

Weitere Informationen

WTS_SESSION_INFO