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

另请参阅

VirtualChannelOpen

VirtualChannelOpenEvent

WTSVirtualChannelRead