Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A API dos Serviços de Ambiente de Trabalho Remoto permite-lhe enumerar e gerir servidores, sessões de cliente e processos de Anfitrião de Sessões de Ambiente de Trabalho Remoto (Anfitrião de Sessões de RD).
Para recuperar os nomes de todos os servidores de Anfitrião de Sessões de RD num domínio, chame a função NetServerEnum para enumerar servidores do tipo SV_TYPE_TERMINALSERVER. Para abrir um identificador para um servidor de Anfitrião de Sessões de RD específico, passe o nome do servidor numa chamada para a função deWTSOpenServer. Quando terminar de usar o identificador, libere-o chamando a funçãoWTSCloseServer.
Você pode usar o identificador retornado por WTSOpenServer para executar as seguintes operações no servidor.
| Função | Funcionamento |
|---|---|
| WTSDisconnectSession | Desconecta o cliente de uma sessão especificada. A sessão permanece ativa e o usuário pode fazer logon novamente para se conectar à mesma sessão. |
| WTSEnumerateSessions | Retorna uma lista de sessões no servidor Host de Sessão RD especificado. |
| WTSEnumerateProcesses | Retorna uma lista de processos no servidor Host de Sessão RD especificado. |
| WTSLogoffSession | Efetua logoff da sessão especificada. |
| WTSQuerySessionInformation | Retorna informações sobre a sessão especificada no servidor Host da Sessão RD especificado. |
| WTSSendMessage | Mostra uma caixa de mensagem na exibição do cliente de uma sessão especificada. |
| WTSShutdownSystem | Desliga e, opcionalmente, reinicia um servidor de Anfitrião de Sessões de RD especificado. |
| WTSTerminateProcess | Encerra um processo especificado em um servidor Host de Sessão RD especificado. |
| WTSVirtualChannelOpen | Abre um identificador para a extremidade do servidor de um canal virtual especificado. Para obter mais informações sobre canais virtuais, consulte Usando canais virtuais dos Serviços de Área de Trabalho Remota. |
| WTSWaitSystemEvent | Aguarda um evento, como a criação de uma sessão de cliente ou de um utilizador que inicia sessão no servidor de Anfitrião de Sessões de RD. |
Várias dessas funções alocam buffers para retornar informações ao chamador. Quando terminar de usar o buffer, liberte-o chamando a funçãoWTSFreeMemory.