Remotedesktopdienste Verwaltung
Mit Remotedesktopdienste-API können Sie Remotedesktop-Sitzungshost (RD-Sitzungshost), Clientsitzungen und Prozesse aufzählen und verwalten.
Rufen Sie zum Abrufen der Namen aller RD-Sitzungshost Server in einer Domäne die NetServerEnum-Funktion auf, um Server vom Typ SV _ TYPE _ TERMINALSERVER aufzählen. Um ein Handle für einen bestimmten RD-Sitzungshost 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 WTSCloseServer-Funktion aufrufen.
Sie können das von WTSOpenServer zurückgegebene Handle verwenden, um die folgenden Vorgänge auf dem Server durchzufü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-Sitzungshost zurück. |
| WTSEnumerateProcesses | Gibt eine Liste der Prozesse auf dem angegebenen RD-Sitzungshost zurück. |
| WTSLogoffSession | Meldet die angegebene Sitzung ab. |
| WTSQuerySessionInformation | Gibt Informationen über die angegebene Sitzung auf dem angegebenen RD-Sitzungshost zurück. |
| WTSSendMessage | Zeigt ein Meldungsfeld auf der Clientanzeige einer angegebenen Sitzung an. |
| WTSShutdownSystem | Fährt einen angegebenen Server herunter und startet RD-Sitzungshost neu. |
| WTSTerminateProcess | Beendet einen angegebenen Prozess auf einem angegebenen RD-Sitzungshost Server. |
| WTSVirtualChannelOpen | Öffnet ein Handle für das Serverende eines angegebenen virtuellen Kanals. Weitere Informationen zu virtuellen Kanälen finden Sie unter Using Remotedesktopdienste Virtual Channels. |
| Wtswaitsystemevent | Wartet auf ein Ereignis, z. B. die Erstellung einer Clientsitzung oder eines Benutzers, der sich beim RD-Sitzungshost anmelden. |
Mehrere dieser Funktionen weisen Puffer zu, um Informationen an den Aufrufer zurückgibt. Wenn Sie die Verwendung des Puffers abgeschlossen haben, geben Sie ihn frei, indem Sie die WTSFreeMemory-Funktion aufrufen.