WTSVirtualChannelOpenEx函数功能

Posted 2021-11-10 道亦无名

功能说明：

此 API 支持静态虚拟通道 (SVC) 和动态虚拟通道 (DVC) 创建。 如果 flags 参数为零，则其行为与 WTSVirtualChannelOpen 相同。 可以通过指定适当的标志来打开 DVC。 创建 DVC 后，您可以使用与 SVC 相同的读取、写入、查询或关闭函数。

用法：

HANDLE WTSVirtualChannelOpenEx(
  [in] DWORD SessionId,
  [in] LPSTR pVirtualName,
  [in] DWORD flags
);

参数说明：

SessionId ： 远程桌面服务会话标识符。 要指示当前会话，请指定 WTS_CURRENT_SESSION。 您可以使用 WTSEnumerateSessions 函数来检索指定 RD 会话主机服务器上所有会话的标识符。

要能够在另一个用户的会话中打开虚拟频道，您必须具有虚拟频道权限。 有关详细信息，请参阅远程桌面服务权限。 要修改会话权限，请使用远程桌面服务配置管理工具。

pVirtualName: 在 SVC 的情况下，指向包含虚拟通道名称的以空字符结尾的字符串。 SVC 名称的长度限制为 CHANNEL_NAME_LEN 字符，不包括终止空值。

在 DVC 的情况下，指向包含侦听器端点名称的以空字符结尾的字符串。 DVC 名称的长度限制为 MAX_PATH 个字符。

flags:
要将通道作为 SVC 打开，请为此参数指定零。要将频道作为 DVC 打开，请指定 WTS_CHANNEL_OPTION_DYNAMIC。

打开 DVC 时，您可以通过指定 WTS_CHANNEL_OPTION_DYNAMIC_PRI_XXX 值之一与 WTS_CHANNEL_OPTION_DYNAMIC 值来为正在传输的数据指定优先级设置。
WTS_CHANNEL_OPTION_DYNAMIC_NO_COMPRESS

禁用此 DVC 的压缩。您必须结合 WTS_CHANNEL_OPTION_DYNAMIC 值指定此值。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_LOW（默认）

低优先级。数据将以低优先级在双方发送。将此优先级用于所有大小的块传输，其中传输速度并不重要。在几乎所有 (95%) 情况下，通道都应使用此标志打开。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_MED

中等优先级。使用此优先级发送短控制消息，这些消息必须优先于低优先级通道中的数据。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_HIGH

高优先级。将此优先级用于关键且直接影响用户体验的数据。传输大小可能会有所不同。显示数据属于这一类。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_REAL

实时优先。仅在数据传输绝对关键的情况下才使用此优先级。数据传输大小应限制为每条消息几百字节。

返回值：

设置 GetLastError 时出错为 NULL。