função de retorno de chamada CHANNEL_INIT_EVENT_FN (cchannel.h)
Uma função de retorno de chamada definida pelo aplicativo que os Serviços de Área de Trabalho Remota chamam para notificar a DLL do cliente de eventos de canal virtual.
O tipo PCHANNEL_INIT_EVENT_FN define um ponteiro para essa função de retorno de chamada. VirtualChannelInitEvent é um espaço reservado para o nome da função definida pelo aplicativo ou definida pela biblioteca.
Sintaxe
CHANNEL_INIT_EVENT_FN ChannelInitEventFn;
VOID VCAPITYPE ChannelInitEventFn(
[in] LPVOID pInitHandle,
[in] UINT event,
[in] LPVOID pData,
[in] UINT dataLength
)
{...}
Parâmetros
[in] pInitHandle
Manipule para a conexão do cliente. Esse é o identificador retornado no parâmetro ppInitHandle da função VirtualChannelInit .
[in] event
Indica o evento que causou a notificação. Esse parâmetro pode usar um dos valores a seguir.
CHANNEL_EVENT_INITIALIZED (0)
A inicialização do cliente RDC (Conexão de Área de Trabalho Remota) foi concluída. O parâmetro pData é NULL.
CHANNEL_EVENT_CONNECTED (1)
Uma conexão foi estabelecida com um servidor host de sessão de área de trabalho remota que dá suporte a canais virtuais. O parâmetro pData é um ponteiro para uma cadeia de caracteres terminada em nulo com o nome do servidor.
CHANNEL_EVENT_V1_CONNECTED (2)
Uma conexão foi estabelecida com um servidor host de sessão de área de trabalho remota que não dá suporte a canais virtuais. O parâmetro pData é NULL.
CHANNEL_EVENT_DISCONNECTED (3)
A conexão com o servidor host da sessão rd foi desconectada. O parâmetro pData é NULL.
CHANNEL_EVENT_TERMINATED (4)
O cliente foi encerrado. O parâmetro pData é NULL.
CHANNEL_EVENT_REMOTE_CONTROL_START (5)
Uma operação de controle remoto foi iniciada. O parâmetro pData é NULL.
CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)
Uma operação de controle remoto foi encerrada. O parâmetro pData é um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do servidor.
[in] pData
Ponteiro para dados adicionais para o evento. O tipo de dados depende do evento, conforme descrito anteriormente nas descrições do evento.
[in] dataLength
Especifica o tamanho, em bytes, dos dados no buffer pData .
Retornar valor
Essa função não retorna um valor.
Comentários
A DLL do cliente usa a função VirtualChannelInit para registrar sua função VirtualChannelInitEvent com os Serviços de Área de Trabalho Remota.
Essa função é reentrada por identificador. A função pode ser chamada enquanto está em execução, mas não no mesmo identificador mais de uma vez.
Essa função é chamada somente após a conclusão do VirtualChannelEntry .
CHANNEL_EVENT_CONNECTED e CHANNEL_EVENT_DISCONNECTED notificações de evento não serão enviadas se a conexão for transferida para outra sessão. No entanto, o plug-in do lado do servidor que está administrando a sessão para a qual a conexão é transferida receberá uma notificação de reconexão. Uma ferramenta do lado do servidor, como Tscon.exe, pode ser usada para transferir conexões. Consulte Monitoramento de Connections de Sessão e Desconexões para obter mais informações sobre notificações de reconexão.
Se o plug-in do modo de usuário precisar ser notificado de que ele foi reconectado (por exemplo, se precisar redefinir seu estado), o plug-in do lado do servidor deverá enviar uma mensagem de notificação ao cliente. Essa notificação deve usar o protocolo que os plug-ins usam para se comunicarem entre si.
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 |