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 |