MsRdpClient4 类

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

此类实现以下接口。

• IMsRdpClient4
• IMsRdpClient3
• IMsRdpClient2
• IMsRdpClient
• IMsTscAx
• IDispatch
• IMsTscAxEvents
• IMsTscNonScriptable
• IMsRdpClientNonScriptable
• IMsRdpClientNonScriptable2

MsRdpClient4 具有以下类型的成员：

• 方法
• 属性

方法

MsRdpClient4 类具有这些方法。

方法	说明
连接	使用控件上当前设置的属性启动连接。
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	设置客户端控件的虚拟通道选项。

属性

MsRdpClient4 类具有这些属性。

属性	访问类型	说明
AdvancedSettings	只读	IMsTscAdvancedSettings 接口指针。
AdvancedSettings2	只读	指向 IMsRdpClientAdvancedSettings 接口的 指针，用于设置客户端控件的高级设置。
AdvancedSettings3	只读	指向 IMsRdpClientAdvancedSettings2 接口的指针，用于设置客户端控件的高级设置。
AdvancedSettings4	只读	指向 IMsRdpClientAdvancedSettings3 接口的指针，用于设置客户端控件的高级设置。
AdvancedSettings5	只读	IMsRdpClientAdvancedSettings4 接口指针。
BinaryPassword	读取/写入	不支持此属性。
BinarySalt	读取/写入	不支持此属性。
CipherStrength	只读	当前控件的最大加密强度。
ClearTextPassword	只写	远程桌面 ActiveX 控制密码，采用纯文本格式。
ColorDepth	读取/写入	当前控件的颜色深度。
已连接	只读	当前控件的连接状态。
ConnectedStatusText	读取/写入	控件处于连接状态时在控件的工作区中显示的文本。
连接文本	读取/写入	控件正在连接时在控件中显示的文本。
DesktopHeight	读取/写入	当前控件在初始远程桌面上的高度（以像素为单位）。
DesktopWidth	读取/写入	初始远程桌面上当前控件的宽度（以像素为单位）。
DisconnectedText	读取/写入	终止连接之前在 控件中显示的文本。
域	读取/写入	当前用户登录到的域。
ExtendedDisconnectReason	只读	有关客户端控件断开连接原因的扩展信息。
全屏	读取/写入	指示控件是否处于全屏模式。
FullScreenTitle	只写	控件处于全屏模式时显示的窗口标题。
HorizontalScrollBarVisible	只读	指示控件是否显示水平滚动条。
PortablePassword	读取/写入	不支持此属性。
PortableSalt	读取/写入	不支持此属性。
SecuredSettings	只读	IMsTscSecuredSettings 接口指针。
SecuredSettings2	只读	指向 IMsRdpClientSecuredSettings 接口的 指针，用于设置客户端控件的安全设置。
SecuredSettingsEnabled	只读	指示 IMsTscSecuredSettings 接口是否可用。
服务器	读取/写入	当前控件连接到的服务器的名称。
StartConnected	读取/写入	指示控件是否会在启动时立即建立 RD 会话主机服务器连接。
UIParentWindowHandle	读取/写入	控件的父窗口的窗口句柄。 这样，控件显示的任何窗口就父应用程序显示的任何窗口都可以正确模式化。
用户	读取/写入	用户名登录凭据。
版本	只读	当前控件的版本号。
VerticalScrollBarVisible	只读	指示控件是否显示垂直滚动条。

要求

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

另请参阅

远程桌面 ActiveX 控件类