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)

Confira também

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose