WTSVirtualChannelOpen 函数 (wtsapi32.h)
打开指向指定虚拟通道的服务器端的句柄。
此函数已过时。 请改用 WTSVirtualChannelOpenEx 函数。
语法
HANDLE WTSVirtualChannelOpen(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] LPSTR pVirtualName
);
参数
[in] hServer
此参数必须是WTS_CURRENT_SERVER_HANDLE。
[in] SessionId
远程桌面服务会话标识符。 若要指示当前会话，请指定 WTS_CURRENT_SESSION。 可以使用 WTSEnumerateSessions 函数检索指定 RD 会话主机服务器上所有会话的标识符。
若要在另一用户的会话上打开虚拟通道，需要具有虚拟通道的权限。 有关详细信息，请参阅 远程桌面服务权限。 若要修改会话的权限，请使用远程桌面服务配置管理工具。
[in] pVirtualName
指向包含虚拟通道名称的 以 null 结尾的字符串的指针。 请注意，即使定义了 UNICODE，这也是 ANSI 字符串。 虚拟通道名称由 1 到 CHANNEL_NAME_LEN 个字符组成，不包括终止 null。
返回值
如果函数成功，则返回值是指定虚拟通道的句柄。
如果函数失败，则返回值为 NULL。 要获得更多的错误信息，请调用 GetLastError。
注解
使用完句柄后，通过调用 WTSVirtualChannelClose 函数释放它。
有关演示如何获取可用于异步 I/O 的虚拟通道文件句柄的访问权限的示例，请参阅 WTSVirtualChannelQuery。
如果尝试多次使用此函数打开同一虚拟通道，可能会导致 10 秒延迟并中断已建立的通道。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | wtsapi32.h |
| Library | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| API 集 | 在 Windows 8) 中引入的 ext-ms-win-session-wtsapi32-l1-1-0 ( |