IWTSSBPlugin::WTSSBX_GetUserExternalSession 方法 (tssbx.h)
[Windows Server 2008 R2 之后不支持 IWTSSBPlugin 接口。 从Windows Server 2012开始,请使用 ITsSbPlugin 接口。]
通过提供包含资源相关信息的 WTSSBX_MACHINE_CONNECT_INFO 结构,将传入连接重定向到计算资源,例如虚拟机、边栏服务器,甚至用户自己的公司桌面。
语法
HRESULT WTSSBX_GetUserExternalSession(
[in] WCHAR *UserName,
[in] WCHAR *DomainName,
[in] WCHAR *ApplicationType,
[in] WTSSBX_IP_ADDRESS *RedirectorInternalIP,
[out] DWORD *pSessionId,
[out] WTSSBX_MACHINE_CONNECT_INFO *pMachineConnectInfo
);
参数
[in] UserName
指向包含传入连接的用户名的 Unicode 字符串的指针。
[in] DomainName
指向包含传入连接的域名的 Unicode 字符串的指针。
[in] ApplicationType
指向 Unicode 字符串的指针,该字符串包含远程桌面服务在创建用户会话后运行的程序。
[in] RedirectorInternalIP
指向第一次接受连接的 RD 会话主机服务器的内部 IP 地址的指针。
[out] pSessionId
指向插件要将传入连接重定向到的会话的会话 ID 的指针。
[out] pMachineConnectInfo
指向 WTSSBX_MACHINE_CONNECT_INFO 结构的指针,该结构包含有关插件将传入连接定向到的计算机的信息。
返回值
如果成功,则返回 S_OK 。
注解
终端服务会话代理 (TS 会话代理) 调用此方法,以便插件可以将传入连接重定向到未加入 TS 会话代理中的场的计算机。
如果 WTSSBX_GetUserExternalSession 的实现不支持重定向到未加入 TS 会话代理中的场的计算机,则它应返回 E_NOTIMPL 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | tssbx.h |