Správa služby Vzdálená plocha
Rozhraní API služby Vzdálená plocha umožňuje vytvořit výčet a správu serverů, klientských relací a procesů hostitele relací vzdálené plochy (hostitel relace VP).
Chcete-li načíst názvy všech serverů hostitele relace VP v doméně, zavolejte funkci NetServerEnum k vytvoření výčtu serverů typu SV_TYPE_TERMINALSERVER. Pokud chcete otevřít popisovač pro konkrétní server hostitele relace VP, předejte název serveru při volání funkce WTSOpenServer. Po dokončení použití popisovače ho uvolněte voláním funkce WTSCloseServer.
Popisovač vrácený WTSOpenServer můžete použít k provedení následujících operací na serveru.
| Funkce | Operace |
|---|---|
| WTSDisconnectSession | Odpojí klienta od zadané relace. Relace zůstane aktivní a uživatel se může znovu přihlásit a připojit se ke stejné relaci. |
| WTSEnumerateSessions | Vrátí seznam relací na zadaném serveru hostitele relace VP. |
| WTSEnumerateProcesses | Vrátí seznam procesů na zadaném serveru hostitele relace VP. |
| WTSLogoffSession | Odhlásí se ze zadané relace. |
| WTSQuerySessionInformation | Vrátí informace o zadané relaci na zadaném serveru hostitele relace VP. |
| WTSSendMessage | Zobrazí okno se zprávou na zobrazení zadané relace klienta. |
| WTSShutdownSystem | Vypne a volitelně restartuje zadaný server hostitele relace VP. |
| WTSTerminateProcess | Ukončí zadaný proces na zadaném serveru hostitele relace VP. |
| WTSVirtualChannelOpen | Otevře popisovač na konec serveru zadaného virtuálního kanálu. Další informace o virtuálních kanálech naleznete v tématu Použití virtuálních kanálů vzdálené plochy. |
| WTSWaitSystemEvent | Čeká na událost, například vytvoření relace klienta nebo přihlášení uživatele k serveru hostitele relace VP. |
Několik z těchto funkcí přiděluje vyrovnávací paměti pro vrácení informací volajícímu. Jakmile dokončíte použití vyrovnávací paměti, uvolněte ji voláním WTSFreeMemory funkce.