Función de devolución de llamada VIRTUALCHANNELWRITE (cchannel.h)
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 .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | cchannel.h |