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

另请参阅

VirtualChannelClose

VirtualChannelInit

VirtualChannelInitEvent

VirtualChannelOpenEvent

VirtualChannelWrite