IRDPSRAPIVirtualChannelManager::CreateVirtualChannel 方法 (rdpencomapi.h)

创建虚拟通道。

语法

HRESULT CreateVirtualChannel(
  [in]  BSTR                    bstrChannelName,
  [in]  CHANNEL_PRIORITY        Priority,
  [in]  unsigned long           ChannelFlags,
  [out] IRDPSRAPIVirtualChannel **ppChannel
);

参数

[in] bstrChannelName

类型: BSTR

信道的名称。 最大长度为 8 个字符,包括 null 终止字符。 旧频道名称限制为 32 个字符。

[in] Priority

类型: CHANNEL_PRIORITY

通道的优先级。 此参数的取值可为下列值之一:

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

类型: 无符号 long

确定如何在通道上发送数据的标志。 此参数可以是 0 或 CHANNEL_FLAGS_UNCOMPRESSED

[out] ppChannel

类型: IRDPSRAPIVirtualChannel**

IRDPSRAPIVirtualChannel 接口指针。

返回值

类型: HRESULT

如果该方法成功,则 返回值S_OK。 否则,返回值为错误代码。 下面是一个可能的值。

注解

创建虚拟通道时,每个打开的通道都会在 RDP 堆栈层绑定 RDP 虚拟通道。 若要在客户端和服务器之间实际打开通道,客户端和服务器都必须绑定通道。 Priority 参数用于为通道上发送的数据包分配优先级。

服务器和客户端通道之间的绑定基于通道名称建立。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 rdpencomapi.h
DLL RdpEncom.dll

另请参阅

IRDPSRAPIVirtualChannelManager