CHANNEL_INIT_EVENT_FN función de devolución de llamada (cchannel.h)
Función de devolución de llamada definida por la aplicación que los Servicios de Escritorio remoto llaman para notificar al archivo DLL de cliente de eventos de canal virtual.
El tipo PCHANNEL_INIT_EVENT_FN define un puntero a esta función de devolución de llamada. VirtualChannelInitEvent es un marcador de posición para el nombre de función definido por la aplicación o definido por la biblioteca.
Sintaxis
CHANNEL_INIT_EVENT_FN ChannelInitEventFn;
VOID VCAPITYPE ChannelInitEventFn(
[in] LPVOID pInitHandle,
[in] UINT event,
[in] LPVOID pData,
[in] UINT dataLength
)
{...}
Parámetros
[in] pInitHandle
Identificador de la conexión de cliente. Este es el identificador devuelto en el parámetro ppInitHandle de la función VirtualChannelInit .
[in] event
Indica el evento que provocó la notificación. Este parámetro puede ser uno de los valores siguientes.
CHANNEL_EVENT_INITIALIZED (0)
Se ha completado la inicialización del cliente de conexión a Escritorio remoto (RDC). El parámetro pData es NULL.
CHANNEL_EVENT_CONNECTED (1)
Se ha establecido una conexión con un servidor host de sesión de Escritorio remoto que admite canales virtuales. El parámetro pData es un puntero a una cadena terminada en null con el nombre del servidor.
CHANNEL_EVENT_V1_CONNECTED (2)
Se ha establecido una conexión con un servidor host de sesión de Escritorio remoto que no admite canales virtuales. El parámetro pData es NULL.
CHANNEL_EVENT_DISCONNECTED (3)
La conexión al servidor host de sesión de Escritorio remoto se ha desconectado. El parámetro pData es NULL.
CHANNEL_EVENT_TERMINATED (4)
Se ha terminado el cliente. El parámetro pData es NULL.
CHANNEL_EVENT_REMOTE_CONTROL_START (5)
Se ha iniciado una operación de control remoto. El parámetro pData es NULL.
CHANNEL_EVENT_REMOTE_CONTROL_STOP (6)
Se ha finalizado una operación de control remoto. El parámetro pData es un puntero a una cadena terminada en null que contiene el nombre del servidor.
[in] pData
Puntero a datos adicionales para el evento. El tipo de datos depende del evento, como se ha descrito anteriormente en las descripciones de eventos.
[in] dataLength
Especifica el tamaño, en bytes, de los datos del búfer pData .
Valor devuelto
Esta función no devuelve ningún valor.
Observaciones
El archivo DLL de cliente usa la función VirtualChannelInit para registrar su función VirtualChannelInitEvent con Servicios de Escritorio remoto.
Esta función se reentranta por controlador. Se puede llamar a la función mientras se ejecuta, pero no en el mismo identificador más de una vez.
Esta función se llama solo después de que VirtualChannelEntry se haya completado.
CHANNEL_EVENT_CONNECTED y CHANNEL_EVENT_DISCONNECTED notificaciones de eventos no se enviarán si la conexión se transfiere a otra sesión. Sin embargo, el complemento del lado servidor que administra la sesión a la que se transfiere la conexión recibirá una notificación de reconexión. Una herramienta del lado servidor, como Tscon.exe, se puede usar para transferir conexiones. Consulte Supervisión de Connections de sesión y desconexiones para obtener más información sobre las notificaciones de reconexión.
Si el complemento en modo de usuario debe recibir una notificación de que se ha vuelto a conectar (por ejemplo, si debe restablecer su estado), el complemento del lado servidor debe enviar un mensaje de notificación al cliente. Esta notificación debe usar el protocolo que los complementos usan para comunicarse entre sí.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | cchannel.h |