Función de devolución de llamada VIRTUALCHANNELWRITE (cchannel.h)

Artículo
02/26/2024

Envía datos del final del cliente de un canal virtual a una aplicación asociada en el extremo del servidor.

Servicios de Escritorio remoto proporciona un puntero a una función VirtualChannelWrite en la estructura de CHANNEL_ENTRY_POINTS pasada al punto de entrada VirtualChannelEntry .

Sintaxis

VIRTUALCHANNELWRITE Virtualchannelwrite;

UINT VCAPITYPE Virtualchannelwrite(
  [in] DWORD openHandle,
  [in] LPVOID pData,
  [in] ULONG dataLength,
  [in] LPVOID pUserData
)
{...}

Parámetros

[in] openHandle

Identificador del canal virtual. Este es el identificador devuelto en el parámetro pOpenHandle de la función VirtualChannelOpen .

[in] pData

Puntero a un búfer que contiene los datos que se van a escribir.

[in] dataLength

Especifica el número de bytes de los datos en el búfer pData que se va a escribir.

[in] pUserData

Valor definido por la aplicación. Este valor se pasa a la función VirtualChannelOpenEvent cuando se completa o cancela la operación de escritura.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se CHANNEL_RC_OK.

Si se produce un error, la función devuelve uno de los valores siguientes.

Comentarios

La función VirtualChannelWrite es asincrónica. Una vez completada la operación de escritura, la función VirtualChannelOpenEvent recibe una notificación CHANNEL_EVENT_WRITE_COMPLETE. Hasta que se reciba esa notificación, el autor de la llamada no debe liberar ni reutilizar el búfer pData pasado a VirtualChannelWrite.

El valor especificado para el parámetro pUserData se pasa a la función VirtualChannelOpenEvent cuando se completa o cancela la operación de escritura. Puede usar estos datos para identificar la operación de escritura.

El complemento de servidor al final del servidor del canal virtual llama a la función WTSVirtualChannelRead para leer los datos escritos por una llamada a VirtualChannelWrite .