Administração de Serviços de Área de Trabalho Remota
A API de Serviços de Área de Trabalho Remota permite que você enumere e gerencie servidores, sessões de cliente e processos do Host da Sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota).
Para recuperar os nomes de todos os servidores host da sessão rd em um domínio, chame a função NetServerEnum para enumerar servidores do tipo SV_TYPE_TERMINALSERVER. Para abrir um identificador para um servidor host de sessão rd específico, passe o nome do servidor em uma chamada para a função WTSOpenServer . Quando terminar de usar o identificador, libere-o chamando a função WTSCloseServer .
Você pode usar o identificador retornado por WTSOpenServer para executar as operações a seguir no servidor.
| Função | Operação |
|---|---|
| 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 da sessão rd especificado. |
| WTSEnumerateProcesses | Retorna uma lista de processos no servidor host da sessão rd especificado. |
| WTSLogoffSession | Faz 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 host de sessão 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 o logon de um usuário no servidor Host da Sessão de Área de Trabalho Remota. |
Várias dessas funções alocam buffers para retornar informações ao chamador. Quando terminar de usar o buffer, libere-o chamando a função WTSFreeMemory .