VIRTUALCHANNELOPEN 回调函数 (cchannel.h)
打开虚拟通道的客户端端。
远程桌面服务提供指向传递到 VirtualChannelEntry 入口点的 CHANNEL_ENTRY_POINTS 结构中的 VirtualChannelOpen 函数的指针。
语法
VIRTUALCHANNELOPEN Virtualchannelopen;
UINT VCAPITYPE Virtualchannelopen(
[in] LPVOID pInitHandle,
[out] LPDWORD pOpenHandle,
[in] PCHAR pChannelName,
[in] PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}
参数
[in] pInitHandle
客户端连接的句柄。 这是 VirtualChannelInit 函数的 ppInitHandle 参数中返回的句柄。
[out] pOpenHandle
指向变量的指针，该变量接收一个句柄，该句柄标识对 VirtualChannelWrite 和 VirtualChannelClose 函数的后续调用中打开的虚拟通道。
[in] pChannelName
指向以 null 结尾的 ANSI 字符串的指针，该字符串包含要打开的虚拟通道的名称。 客户端调用 VirtualChannelInit 函数时，必须注册该名称。
[in] pChannelOpenEventProc
指向应用程序定义的 VirtualChannelOpenEvent 函数的指针，远程桌面服务调用该函数以通知客户端 DLL 此虚拟通道的事件。
返回值
如果函数成功，则返回值CHANNEL_RC_OK。
如果发生错误，该函数将返回以下值之一。
注解
在客户端与 RD 会话主机服务器建立连接之前，客户端 DLL 无法调用此函数。 建立 RD 会话主机服务器连接时 ，VirtualChannelInitEvent 函数会收到CHANNEL_EVENT_CONNECTED通知。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | cchannel.h |