IMsRdpClient9 接口

提供配置和使用客户端控件所需的方法和属性。 派生自 IMsRdpClient8 接口。

成员

IMsRdpClient9 接口继承自 IMsRdpClient8。 IMsRdpClient9 还具有以下类型的成员：

• 方法
• 属性

方法

IMsRdpClient9 接口包含以下方法。

方法	说明
attachEvent	附加事件。
连接	使用控件上当前设置的属性启动连接。
CreateVirtualChannels	为每个指定的虚拟通道名称创建客户端虚拟通道对象。
detachEvent	分离事件。
断开连接	断开活动连接。
GetErrorDescription	检索会话断开连接事件的错误说明。
GetStatusText	检索指定状态代码的状态文本。
GetVirtualChannelOptions	检索为虚拟通道设置的选项。
重新连接	使用新的桌面宽度和高度重新连接到远程会话。
RequestClose	请求正常关闭远程桌面 ActiveX 控件。
SendOnVirtualChannel	通过先前使用 CreateVirtualChannels 方法创建的虚拟通道将数据发送到 RD 会话主机服务器。
SendRemoteAction	导致在远程会话中执行操作。
SetVirtualChannelOptions	设置远程桌面 ActiveX 控件的虚拟通道选项。
SyncSessionDisplaySettings	同步会话显示设置。
UpdateSessionDisplaySettings	汇报会话显示设置。

属性

IMsRdpClient9 接口具有以下属性。

属性	访问类型	说明
AdvancedSettings	只读	检索 IMsTscAdvancedSettings 接口指针。
AdvancedSettings2	只读	检索指向 IMsRdpClientAdvancedSettings 接口的 指针。 接口可用于设置客户端控件的高级设置。
AdvancedSettings3	只读	检索指向 IMsRdpClientAdvancedSettings2 接口的 指针。 接口可用于设置客户端控件的高级设置。
AdvancedSettings4	只读	检索指向 IMsRdpClientAdvancedSettings3 接口的 指针。
AdvancedSettings5	只读	检索指向 IMsRdpClientAdvancedSettings4 接口的 指针。
AdvancedSettings6	只读	检索 IMsRdpClientAdvancedSettings5 接口。
AdvancedSettings7	只读	检索 IMsRdpClientAdvancedSettings6 接口。
AdvancedSettings8	只读	检索支持 IMsRdpClientAdvancedSettings7 接口的对象 。
AdvancedSettings9	只读	包含支持 IMsRdpClientAdvancedSettings8 接口的对象 。
CipherStrength	只读	检索当前控件的最大加密强度。
ColorDepth	读取/写入	控件连接的颜色深度 (位/像素) 。
已连接	只读	检索当前控件的连接状态。
ConnectedStatusText	读取/写入	包含控件处于连接状态时显示在控件工作区中的文本。
ConnectingText	读取/写入	指定在控件连接时在控件中居中显示的文本。
DesktopHeight	读取/写入	指定初始远程桌面上当前控件的高度（以像素为单位）。
DesktopWidth	读取/写入	指定初始远程桌面上当前控件的宽度（以像素为单位）。
DisconnectedText	读取/写入	指定在终止连接之前在控件中显示为居中的文本。
域	读取/写入	指定当前用户登录到的域。
ExtendedDisconnectReason	只读	包含有关控件断开连接原因的扩展信息。
全屏	读取/写入	确定客户端控件是否处于全屏模式。
FullScreenTitle	只写	指定控件处于全屏模式时显示的窗口标题。
HorizontalScrollBarVisible	只读	指示控件是否显示水平滚动条。
MsRdpClientShell	只读	检索可编写脚本的客户端设置接口 IMsRdpClientShell。
RemoteProgram	只读	检索支持 ITSRemoteProgram 接口的 对象。
RemoteProgram2	只读	检索支持 ITSRemoteProgram2 接口的 对象。
SecuredSettings	只读	检索 IMsTscSecuredSettings 接口指针。
SecuredSettings2	只读	检索指向 IMsRdpClientSecuredSettings 接口的 指针。 此接口可用于设置客户端控件的安全设置。
SecuredSettings3	只读	检索支持 IMsRdpClientSecuredSettings2 接口的对象。
SecuredSettingsEnabled	只读	指示 IMsTscSecuredSettings 接口是否可用。 也就是说，包含控件的网页当前是否位于允许的 Internet Explorer URL 安全区域中。
服务器	读取/写入	指定当前控件连接到的服务器的名称。
StartConnected	读取/写入	指示控件是否会在启动时立即建立 RD 会话主机服务器连接。
TransportSettings	只读	检索通过脚本传递到 IMsRdpClientTransportSettings 接口的内容。
TransportSettings2	只读	检索 IMsRdpClientTransportSettings2 接口。
TransportSettings3	只读	检索支持 IMsRdpClientTransportSettings3 接口的对象 。
TransportSettings4	只读	检索支持 IMsRdpClientTransportSettings4 接口的 对象。
用户	读取/写入	指定用户名登录凭据。
版本	只读	指定当前控件的版本号。
VerticalScrollBarVisible	只读	指示控件是否显示垂直滚动条。

备注

IMsRdpClient9 接口已由以下接口扩展，每个新接口都继承先前接口的所有方法和属性：

• IMsRdpClient10

有关远程桌面 Web 连接的详细信息，请参阅 远程桌面 Web 连接的要求。

要求

要求	值
最低受支持的客户端	Windows 8.1
最低受支持的服务器	Windows Server 2012 R2
类型库	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient10定义为 C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting定义为 A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient9定义为 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting定义为 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID	IID_IMsRdpClient9定义为 28904001-04B6-436C-A55B-0AF1A0883DC9

另请参阅

IMsRdpClient8

IMsRdpClient7

IMsRdpClient6

IMsRdpClient5

IMsRdpClient4

IMsRdpClient3

IMsRdpClient2

IMsRdpClient

IMsTscAx

远程桌面 Web 连接参考