virtualCHANNELWRITE 回调函数 (cchannel.h)
将数据从虚拟通道的客户端发送到服务器端的合作伙伴应用程序。
远程桌面服务提供指向传递给 VirtualChannelEntry 入口点 的CHANNEL_ENTRY_POINTS 结构中的 VirtualChannelWrite 函数的指针。
语法
VIRTUALCHANNELWRITE Virtualchannelwrite;
UINT VCAPITYPE Virtualchannelwrite(
[in] DWORD openHandle,
[in] LPVOID pData,
[in] ULONG dataLength,
[in] LPVOID pUserData
)
{...}
参数
[in] openHandle
虚拟通道的句柄。 这是 VirtualChannelOpen 函数的 pOpenHandle 参数中返回的句柄。
[in] pData
指向包含要写入的数据的缓冲区的指针。
[in] dataLength
指定要写入 的 pData 缓冲区中的数据的字节数。
[in] pUserData
应用程序定义的值。 完成或取消写入操作时，此值将传递给 VirtualChannelOpenEvent 函数。
返回值
如果函数成功，则返回值CHANNEL_RC_OK。
如果发生错误，该函数将返回以下值之一。
注解
VirtualChannelWrite 函数是异步的。 完成写入操作后， VirtualChannelOpenEvent 函数将收到CHANNEL_EVENT_WRITE_COMPLETE通知。 在收到该通知之前，调用方不得释放或重复使用传递给 VirtualChannelWrite 的 pData 缓冲区。
完成或取消写入操作时，为 pUserData 参数指定的值将传递给 VirtualChannelOpenEvent 函数。 可以使用此数据来标识写入操作。
虚拟通道服务器端的服务器外接程序调用 WTSVirtualChannelRead 函数来读取 VirtualChannelWrite 调用写入的数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | cchannel.h |