Compartilhar via


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