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 de Sessão da Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota).

Para recuperar os nomes de todos os servidores host de 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 pelo WTSOpenServer para executar as seguintes operações 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 de sessão rd especificado.
WTSEnumerateProcesses Retorna uma lista de processos no servidor host de sessão rd especificado.
WTSLogoffSession Faz logon da sessão especificada.
WTSQuerySessionInformation Retorna informações sobre a sessão especificada no servidor host de 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 o final 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 rd.

 

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 .