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

Confira também

Virtualchannelinit