Verwaltung von Remotedesktopdiensten

Mit der Remotedesktopdienste-API können Sie Remotedesktop-Sitzungshostserver (RD-Sitzungshostserver), Clientsitzungen und Prozesse auflisten und verwalten.

Um die Namen aller RD-Sitzungshostserver in einer Domäne abzurufen, rufen Sie die NetServerEnum-Funktion auf, um Server des typs SV_TYPE_TERMINALSERVER aufzulisten. Um ein Handle für einen bestimmten RD-Sitzungshostserver zu öffnen, übergeben Sie den Servernamen in einem Aufruf der WTSOpenServer-Funktion . Wenn Sie die Verwendung des Handles abgeschlossen haben, geben Sie es frei, indem Sie die Funktion WTSCloseServer aufrufen.

Sie können das von WTSOpenServer zurückgegebene 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	Meldet die angegebene Sitzung ab.
WTSQuerySessionInformation	Gibt Informationen zur 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 ein Handle am Serverende eines angegebenen virtuellen Kanals. Weitere Informationen zu virtuellen Kanälen finden Sie unter Verwenden virtueller Remotedesktopdienste-Kanäle.
Wtswaitsystemevent	Wartet auf ein Ereignis, z. B. die Erstellung einer Clientsitzung oder eines Benutzers, der sich beim RD-Sitzungshostserver anmeldet.

 

Mehrere dieser Funktionen weisen Puffer zu, um Informationen an den Aufrufer zurückzugeben. Wenn Sie die Verwendung des Puffers abgeschlossen haben, geben Sie ihn frei, indem Sie die FUNKTION WTSFreeMemory aufrufen.