CHANNEL_INIT_EVENT_FN función de devolución de llamada (cchannel.h)

Artículo
08/22/2023

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

Consulte también

VirtualChannelInit

Share via