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.