Beheer van Extern bureaublad-services
Met de API voor Extern bureaublad-services kunt u extern bureaublad-sessiehostservers, clientsessies en processen opsommen en beheren.
Als u de namen van alle RD Session Host-servers in een domein wilt ophalen, roept u de functie NetServerEnum- aan om servers van het SV_TYPE_TERMINALSERVER-type te inventariseren. Als u een ingang wilt openen naar een specifieke RD Session Host-server, geeft u de servernaam door in een aanroep naar de WTSOpenServer functie. Wanneer u klaar bent met het gebruik van de ingang, laat u deze los door de functie WTSCloseServer aan te roepen.
U kunt de ingang die wordt geretourneerd door WTSOpenServer gebruiken om de volgende bewerkingen uit te voeren op de server.
| Functie | Operatie |
|---|---|
| WTSDisconnectSession- | Hiermee wordt de client losgekoppeld van een opgegeven sessie. De sessie blijft actief en de gebruiker kan zich opnieuw aanmelden om verbinding te maken met dezelfde sessie. |
| WTSEnumerateSessions | Retourneert een lijst met sessies op de opgegeven RD Session Host-server. |
| WTSEnumerateProcesses | Retourneert een lijst met processen op de opgegeven RD Session Host-server. |
| WTSLogoffSession- | Hiermee wordt de opgegeven sessie afgelogd. |
| WTSQuerySessionInformation- | Retourneert informatie over de opgegeven sessie op de opgegeven RD Session Host-server. |
| WTSendMessage- | Toont een berichtvak op de clientweergave van een opgegeven sessie. |
| WTSShutdownSystem | Hiermee wordt een opgegeven RD Session Host-server afgesloten en optioneel opnieuw opgestart. |
| WTSTerminateProcess | Hiermee wordt een opgegeven proces beëindigd op een opgegeven RD Session Host-server. |
| WTSVirtualChannelOpen | Hiermee opent u een ingang naar het servereinde van een opgegeven virtueel kanaal. Zie Virtuele kanalen voor extern bureaublad-services gebruikenvoor meer informatie over virtuele kanalen. |
| WTSWaitSystemEvent | Wacht op een gebeurtenis, zoals het maken van een clientsessie of een gebruiker die zich aanmeldt bij de RD Session Host-server. |
Verschillende van deze functies wijzen buffers toe om informatie te retourneren aan de aanroeper. Wanneer u klaar bent met het gebruik van de buffer, kunt u deze gratis maken door de functie WTSFreeMemory aan te roepen.