Função WTSVirtualChannelOpen (wtsapi32.h)
Abre um identificador para a extremidade do servidor de um canal virtual especificado.
Essa função está obsoleta. Em vez disso, use a função WTSVirtualChannelOpenEx .
Sintaxe
HANDLE WTSVirtualChannelOpen(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] LPSTR pVirtualName
);
Parâmetros
[in] hServer
Esse parâmetro deve ser WTS_CURRENT_SERVER_HANDLE.
[in] SessionId
Um identificador de sessão dos Serviços de Área de Trabalho Remota. Para indicar a sessão atual, especifique WTS_CURRENT_SESSION. Você pode usar a função WTSEnumerateSessions para recuperar os identificadores de todas as sessões em um servidor host de sessão rd especificado.
Para abrir um canal virtual na sessão de outro usuário, você precisa ter permissão do Canal Virtual. Para obter mais informações, consulte Permissões dos Serviços de Área de Trabalho Remota. Para modificar permissões em uma sessão, use a ferramenta administrativa Configuração de Serviços de Área de Trabalho Remota.
[in] pVirtualName
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do canal virtual. Observe que essa é uma cadeia de caracteres ANSI mesmo quando UNICODE é definido. O nome do canal virtual consiste em um para CHANNEL_NAME_LEN caracteres, não incluindo o nulo de terminação.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para o canal virtual especificado.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Quando terminar de usar o identificador, libere-o chamando a função WTSVirtualChannelClose .
Para obter um exemplo que mostra como obter acesso a um identificador de arquivo de canal virtual que pode ser usado para E/S assíncrona, consulte WTSVirtualChannelQuery.
Se você tentar usar essa função para abrir o mesmo canal virtual várias vezes, isso poderá causar um atraso de 10 segundos e interromper o canal estabelecido.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wtsapi32.h |
| Biblioteca | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Conjunto de APIs | ext-ms-win-session-wtsapi32-l1-1-0 (introduzido no Windows 8) |