Udostępnij przez


Administracja usług pulpitu zdalnego

Interfejs API usług pulpitu zdalnego umożliwia wyliczanie serwerów hosta sesji usług pulpitu zdalnego (hosta sesji usług pulpitu zdalnego), sesje klienta i procesy oraz zarządzanie nimi.

Aby pobrać nazwy wszystkich serwerów hosta sesji usług pulpitu zdalnego w domenie, wywołaj funkcję NetServerEnum w celu wyliczenia serwerów typu SV_TYPE_TERMINALSERVER. Aby otworzyć dojście do określonego serwera hosta sesji usług pulpitu zdalnego, przekaż nazwę serwera w wywołaniu do funkcji WTSOpenServer. Po zakończeniu korzystania z dojścia zwolnij go, wywołując funkcję WTSCloseServer.

Aby wykonać następujące operacje na serwerze, można użyć dojścia zwróconego przez WTSOpenServer.

Funkcja Operacja
WTSDisconnectSession Odłącza klienta od określonej sesji. Sesja pozostaje aktywna, a użytkownik może zalogować się ponownie, aby nawiązać połączenie z tą samą sesją.
WTSEnumerateSessions Zwraca listę sesji na określonym serwerze hosta sesji usług pulpitu zdalnego.
WTSEnumerateProcesses Zwraca listę procesów na określonym serwerze hosta sesji usług pulpitu zdalnego.
WTSLogoffSession Wyloguje się z określonej sesji.
WTSQuerySessionInformation Zwraca informacje o określonej sesji na określonym serwerze hosta sesji usług pulpitu zdalnego.
WTSSendMessage Wyświetla pole komunikatu na ekranie klienta określonej sesji.
WTSShutdownSystem Zamyka i opcjonalnie ponownie uruchamia określony serwer hosta sesji usług pulpitu zdalnego.
WTSTerminateProcess Przerywa określony proces na określonym serwerze hosta sesji usług pulpitu zdalnego.
WTSVirtualChannelOtwórz Otwiera dojście na końcu serwera określonego kanału wirtualnego. Aby uzyskać więcej informacji na temat kanałów wirtualnych, zobacz Using Remote Desktop Services Virtual Channels.
WTSWaitSystemEvent Czeka na zdarzenie, takie jak utworzenie sesji klienta lub logowanie użytkownika na serwerze hosta sesji usług pulpitu zdalnego.

 

Kilka z tych funkcji przydziela w celu zwrócenia informacji do obiektu wywołującego. Po zakończeniu korzystania z buforu zwolnij go, wywołując funkcję WTSFreeMemory.