Remotedesktopdiensteverwaltung
Mit der Remotedesktopdienste-API können Sie Remotedesktopsitzungshostserver, Clientsitzungen und Prozesse auflisten und verwalten.
Rufen Sie zum Abrufen der Namen aller RD-Sitzungshostserver in einer Domäne die NetServerEnum--Funktion auf, um Server des SV_TYPE_TERMINALSERVER Typs aufzählen zu können. Um ein Handle auf einem bestimmten RD-Sitzungshostserver zu öffnen, übergeben Sie den Servernamen in einem Aufruf an die WTSOpenServer--Funktion. Wenn Sie mit der Verwendung des Handles fertig sind, lassen Sie es los, indem Sie die WTSCloseServer--Funktion aufrufen.
Sie können das von WTSOpenServer zurückgegebene Handle verwenden, um die folgenden Vorgänge auf dem Server auszuführen.
| Funktion | Operation |
|---|---|
| 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 ab. |
| WTSQuerySessionInformation | Gibt Informationen zur angegebenen Sitzung auf dem angegebenen RD-Sitzungshostserver zurück. |
| WTSendMessage | Zeigt ein Meldungsfeld auf der Clientanzeige einer angegebenen Sitzung an. |
| WTShutdownSystem | 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. |
| 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, geben Sie ihn frei, indem Sie die WTSFreeMemory-Funktion aufrufen.