Verwaltung von Remotedesktopdiensten

Mit der Remotedesktopdienste-API können Sie Remotedesktopsitzungshostserver(RD-Sitzungshost) und Clientsitzungen und Prozesse aufzählen und verwalten.

Um die Namen aller RD-Sitzungshostserver in einer Domäne abzurufen, rufen Sie die NetServerEnum-Funktion auf, um Server des SV_TYPE_TERMINALSERVER-Typs aufzählen zu können. Um einen Handle auf einen bestimmten RD-Sitzungshostserver zu öffnen, übergeben Sie den Servernamen in einem Aufruf an die WTSOpenServer-Funktion . Wenn Sie die Verwendung des Handles abgeschlossen haben, freigeben Sie ihn, indem Sie die WTSCloseServer-Funktion aufrufen.

Sie können den von WTSOpenServer zurückgegebenen Handle verwenden, um die folgenden Vorgänge auf dem Server auszuführen.

Funktion Vorgang
WTSDisconnectSession Trennt den Client von einer angegebenen Sitzung. Die Sitzung bleibt aktiv, und der Benutzer kann sich erneut anmelden, um eine Verbindung mit derselben Sitzung herzustellen.
WTSEnumerateSessions Gibt eine Liste der Sitzungen auf dem angegebenen RD-Sitzungshostserver zurück.
WTSEnumerateProcesses Gibt eine Liste der Prozesse auf dem angegebenen RD-Sitzungshostserver zurück.
WTSLogoffSession Protokolliert die angegebene Sitzung.
WTSQuerySessionInformation Gibt Informationen zu der angegebenen Sitzung auf dem angegebenen RD-Sitzungshostserver zurück.
WTSSendMessage Zeigt ein Meldungsfeld auf der Clientanzeige einer angegebenen Sitzung an.
WTSShutdownSystem Beendet und startet optional einen angegebenen RD-Sitzungshostserver neu.
WTSTerminateProcess Beendet einen angegebenen Prozess auf einem angegebenen RD-Sitzungshostserver.
WTSVirtualChannelOpen Öffnet einen Handle am Serverende eines angegebenen virtuellen Kanals. Weitere Informationen zu virtuellen Kanälen finden Sie unter Verwendung virtueller Kanäle.
Wtswaitsystemevent Wartet auf ein Ereignis, z. B. die Erstellung einer Clientsitzung oder ein Benutzer, der sich beim RD-Sitzungshostserver anmeldet.

 

Mehrere dieser Funktionen weisen Puffer zu, um Informationen an den Aufrufer zurückzugeben. Wenn Sie den Puffer verwendet haben, öffnen Sie ihn, indem Sie die WTSFreeMemory-Funktion aufrufen.