MsRdpClient4 类

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

此类实现以下接口。

MsRdpClient4 具有以下类型的成员:

方法

MsRdpClient4 类具有这些方法。

方法 说明
连接 使用控件上当前设置的属性启动连接。
CreateVirtualChannels 为每个指定的虚拟通道名称创建客户端虚拟通道对象。
断开 断开活动连接。
GetVirtualChannelOptions 检索为虚拟通道设置的选项。
NotifyRedirectDeviceChange 通知远程桌面ActiveX控件的设备重定向模块,系统发生了设备更改。 此方法 将WM_DEVICECHANGE 通知传递给控件。
OnAuthenticationWarningDismissed ActiveX控件后调用的身份验证对话框 (例如,证书错误对话框) 。
OnAuthenticationWarningDisplayed ActiveX控件之前调用的身份验证对话框 (例如,证书错误对话框) 。
OnAutoReconnected 当客户端控件自动重新连接到远程会话时调用。
OnAutoReconnecting 当客户端在自动将会话与 RD 会话主机服务器重新连接的过程中调用。
OnAutoReconnecting2 当客户端在自动将会话与 RD 会话主机服务器重新连接的过程中调用。
OnChannelReceivedData 当客户端在可脚本虚拟通道上接收数据时调用。
OnConfirmClose 当客户端调用 IMsRdpClient::RequestClose 方法时调用。
OnConnected 当客户端控件正在与 RD 会话主机服务器建立连接时调用。
OnConnecting 当客户端控件开始连接到服务器以响应对 IMsTcAx::连接 的调用时调用。
OnConnectionBarPullDown 当用户拖到连接栏上时调用。
OnDevicesButtonPressed 按下连接栏中的设备按钮时调用。
OnDisconnected 当客户端控件与 RD 会话主机服务器断开连接时调用。
OnEnterFullScreenMode 客户端进入全屏模式时调用。 例如,当用户按下全屏模式 快捷键 组合时,将调用此事件, (Ctrl+Alt+BREAK) 。
OnFatalError 当客户端控件遇到致命错误时调用。
OnFocusReleased 按下释放焦点键组合时调用。 例如,当用户按下 Ctrl+Alt+向左键或 Ctrl+Alt+向右键组合时,将调用此事件。
OnIdleTimeoutNotification 当用户在 IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout 方法设置的时间期间没有鼠标或键盘输入时调用。
OnLeaveFullScreenMode 客户端离开全屏模式时调用。 例如,当用户按下全屏模式 快捷键 组合时,将调用此事件, (Ctrl+Alt+BREAK) 。
OnLoginComplete 在客户端控件成功登录到 RD 会话主机服务器时调用,并显示“Windows登录”对话框。
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 通过以前使用 IMstcAx::CreateVirtualChannels 方法创建的虚拟通道将数据发送到 RD 会话主机服务器。
SetVirtualChannelOptions 设置客户端控件的虚拟通道选项。

属性

MsRdpClient4 类具有这些属性。

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

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

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
类型库
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
CLSID_MsRdpClient4定义为 4EDCB26C-D24C-4E72-AF07-B576699AC0DE

另请参阅

远程桌面ActiveX控件类