Delen via


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.