Função de retorno de chamada VIRTUALCHANNELOPEN (cchannel.h)

Abre a extremidade do cliente de um canal virtual.

Os Serviços de Área de Trabalho Remota fornecem um ponteiro para uma função VirtualChannelOpen na estrutura CHANNEL_ENTRY_POINTS passada para o ponto de entrada VirtualChannelEntry .

Sintaxe

VIRTUALCHANNELOPEN Virtualchannelopen;

UINT VCAPITYPE Virtualchannelopen(
  [in]  LPVOID pInitHandle,
  [out] LPDWORD pOpenHandle,
  [in]  PCHAR pChannelName,
  [in]  PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}

Parâmetros

[in] pInitHandle

Manipule para a conexão do cliente. Esse é o identificador retornado no parâmetro ppInitHandle da função VirtualChannelInit .

[out] pOpenHandle

Ponteiro para uma variável que recebe um identificador que identifica o canal virtual aberto em chamadas subsequentes para as funções VirtualChannelWrite e VirtualChannelClose .

[in] pChannelName

Ponteiro para uma cadeia de caracteres ANSI terminada em nulo que contém o nome do canal virtual a ser aberto. O nome deve ter sido registrado quando o cliente chamou a função VirtualChannelInit .

[in] pChannelOpenEventProc

Ponteiro para uma função VirtualChannelOpenEvent definida pelo aplicativo que os Serviços de Área de Trabalho Remota chamam para notificar a DLL do cliente de eventos para esse canal virtual.

Retornar valor

Se a função for bem-sucedida, o valor retornado será CHANNEL_RC_OK.

Se ocorrer um erro, a função retornará um dos valores a seguir.

Comentários

A DLL do cliente não pode chamar essa função até que o cliente tenha estabelecido uma conexão com um servidor host de sessão rd. Sua função VirtualChannelInitEvent recebe uma notificação CHANNEL_EVENT_CONNECTED quando uma conexão de servidor host da sessão rd é estabelecida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho cchannel.h

Confira também

VirtualChannelClose

Virtualchannelinit

VirtualChannelInitEvent

VirtualChannelOpenEvent

VirtualChannelWrite