使用英语阅读

通过


MsRdpClient2 类

Microsoft RDP 客户端控制 (可再发行) - 版本 3

此类实现以下接口。

MsRdpClient2 具有以下类型的成员:

方法

MsRdpClient2 类具有以下方法。

方法 说明
连接 使用控件上当前设置的属性启动连接。
CreateVirtualChannels 为每个指定的虚拟通道名称创建客户端虚拟通道对象。
断开连接 断开活动连接。
GetVirtualChannelOptions 检索为虚拟通道设置的选项。
NotifyRedirectDeviceChange 通知远程桌面 ActiveX 控件的设备重定向模块,系统发生了设备更改。 此方法将 WM_DEVICECHANGE 通知传递给 控件。
OnAuthenticationWarningDismissed 在 ActiveX 控件显示身份验证对话框后调用, (例如,证书错误对话框) 。
OnAuthenticationWarningDisplayed 在 ActiveX 控件显示身份验证对话框之前调用, (例如,证书错误对话框) 。
OnAutoReconnected 当客户端控件自动重新连接到远程会话时调用。
OnAutoReconnecting 在客户端自动将会话与 RD 会话主机服务器重新连接的过程中调用。
OnAutoReconnecting2 在客户端自动将会话与 RD 会话主机服务器重新连接的过程中调用。
OnChannelReceivedData 当客户端在可编写脚本的虚拟通道上接收数据时调用。
OnConfirmClose 在客户端调用 IMsRdpClient::RequestClose 方法时调用。
OnConnected 当客户端控件正在与 RD 会话主机服务器建立连接时调用。
OnConnecting 在客户端控件开始连接到服务器以响应对 IMsTscAx::Connect 的调用时调用。
OnConnectionBarPullDown 当用户在连接栏上向下拖动时调用。
OnDevicesButtonPressed 按下连接栏中的设备按钮时调用。
OnDisconnected 当客户端控件与 RD 会话主机服务器断开连接时调用。
OnEnterFullScreenMode 当客户端进入全屏模式时调用。 例如,当用户按下全屏模式 快捷键 组合 (ctrl+Alt+BREAK) 时,将调用此事件。
OnFatalError 当客户端控件遇到严重错误时调用。
OnFocusReleased 按下释放焦点组合键时调用。 例如,当用户按 Ctrl+Alt+向左键或 Ctrl+Alt+向右键组合键时,将调用此事件。
OnIdleTimeoutNotification IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout 方法设置的时间段内用户未输入鼠标或键盘时调用。
OnLeaveFullScreenMode 在客户端退出全屏模式时调用。 例如,当用户按下全屏模式 快捷键 组合 (ctrl+Alt+BREAK) 时,将调用此事件。
OnLoginComplete 在显示“Windows 登录”对话框后,在客户端控件成功登录到 RD 会话主机服务器时调用。
OnLogonError 在发生登录错误或其他登录事件时调用。
OnMouseInputModeChanged 在鼠标输入模式更改时调用。
OnNetworkStatusChanged 在网络状态更改时调用。
OnReceivedTSPublicKey 当客户端从服务器检索公钥时,在连接序列期间调用。 仅当 NotifyTSPublicKey 属性 VARIANT_TRUE时,才会调用此事件。
OnRemoteDesktopSizeChange 调用以指示远程桌面上的客户端控件的大小已更改,以响应客户端控件操作。
OnRemoteProgramDisplayed 显示 RemoteApp 程序时调用。
OnRemoteProgramResult 当 RemoteApp 程序将结果返回给客户端控件时调用。
OnRemoteWindowDisplayed 显示 RemoteApp 窗口时调用。
OnRequestContainerMinimize 当用户在全屏模式下按下连接栏上的 “最小化 ”按钮时调用。 触发此事件是容器应用程序最小化自身的请求。
OnRequestGoFullScreen 当客户端请求切换到全屏模式并且调用 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen 方法以将 ContainerHandledFullScreen 属性设置为非零值时调用。
OnRequestLeaveFullScreen 当客户端请求退出全屏模式并且 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen 属性已设置为非零值时调用。
OnServiceMessageReceived 在客户端收到系统消息时调用。
OnUserNameAcquired 在控件获取用户名时调用。
OnWarning 当客户端控件遇到非致命错误条件时调用。
RequestClose 请求正常关闭客户端控件。
ResetPassword 重置 控件中的所有密码状态。
SendKeys 向 控件发送一系列击键。 击键采用扫描代码形式,即实际物理键中的键盘数据。
SendOnVirtualChannel 通过之前使用 IMsTscAx::CreateVirtualChannels 方法创建的虚拟通道将数据发送到 RD 会话主机服务器。
SetVirtualChannelOptions 设置客户端控件的虚拟通道选项。

属性

MsRdpClient2 类具有以下属性。

属性 访问类型 说明
AdvancedSettings
只读
IMsTscAdvancedSettings 接口指针。
AdvancedSettings2
只读
指向 IMsRdpClientAdvancedSettings 接口的 指针,用于设置客户端控件的高级设置。
AdvancedSettings3
只读
指向 IMsRdpClientAdvancedSettings2 接口的指针,用于设置客户端控件的高级设置。
BinaryPassword
读取/写入
不支持此属性。
BinarySalt
读取/写入
不支持此属性。
CipherStrength
只读
当前控件的最大加密强度。
ClearTextPassword
只写
远程桌面 ActiveX 以纯文本格式控制密码。
ColorDepth
读取/写入
当前控件的颜色深度。
已连接
只读
当前控件的连接状态。
ConnectedStatusText
读取/写入
控件处于连接状态时在控件的工作区中显示的文本。
ConnectingText
读取/写入
在控件连接时在 控件中显示的文本。
DesktopHeight
读取/写入
初始远程桌面上当前控件的高度(以像素为单位)。
DesktopWidth
读取/写入
初始远程桌面上当前控件的宽度(以像素为单位)。
DisconnectedText
读取/写入
终止连接之前在 控件中显示的文本。

读取/写入
当前用户登录到的域。
ExtendedDisconnectReason
只读
有关客户端控件断开连接原因的扩展信息。
全屏
读取/写入
指示控件是否处于全屏模式。
FullScreenTitle
只写
控件处于全屏模式时显示的窗口标题。
HorizontalScrollBarVisible
只读
指示控件是否显示水平滚动条。
PortablePassword
读取/写入
不支持此属性。
PortableSalt
读取/写入
不支持此属性。
SecuredSettings
只读
IMsTscSecuredSettings 接口指针。
SecuredSettings2
只读
指向 IMsRdpClientSecuredSettings 接口的 指针,用于设置客户端控件的安全设置。
SecuredSettingsEnabled
只读
指示 IMsTscSecuredSettings 接口是否可用。
服务器
读取/写入
当前控件连接到的服务器的名称。
StartConnected
读取/写入
指示控件是否会在启动时立即建立 RD 会话主机服务器连接。
用户
读取/写入
用户名登录凭据。
版本
只读
当前控件的版本号。
VerticalScrollBarVisible
只读
指示控件是否显示垂直滚动条。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
类型库
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
CLSID_MsRdpClient2定义为 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A

另请参阅

远程桌面 ActiveX 控件类