MsRdpClient3 类
Microsoft RDP 客户端控制 (可再发行) - 版本 4
此类实现以下接口。
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
MsRdpClient3 具有以下类型的成员：
方法
MsRdpClient3 类具有这些方法。
| 方法 | 说明 |
|---|---|
| 连接 | 使用控件上当前设置的属性启动连接。 |
| 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 | 设置客户端控件的虚拟通道选项。 |
属性
MsRdpClient3 类具有这些属性。
| 属性 | 访问类型 | 说明 |
|---|---|---|
|
AdvancedSettings |
只读 |
IMsTscAdvancedSettings 接口指针。 |
|
AdvancedSettings2 |
只读 |
指向 IMsRdpClientAdvancedSettings 接口的 指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings3 |
只读 |
指向 IMsRdpClientAdvancedSettings2 接口的指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings4 |
只读 |
指向 IMsRdpClientAdvancedSettings3 接口的指针，用于设置客户端控件的高级设置。 |
|
BinaryPassword |
读取/写入 |
不支持此属性。 |
|
BinarySalt |
读取/写入 |
不支持此属性。 |
|
CipherStrength |
只读 |
当前控件的最大加密强度。 |
|
ClearTextPassword |
只写 |
远程桌面 ActiveX 控制密码，采用纯文本格式。 |
|
ColorDepth |
读取/写入 |
当前控件的颜色深度。 |
|
已连接 |
只读 |
当前控件的连接状态。 |
|
ConnectedStatusText |
读取/写入 |
控件处于连接状态时在控件的工作区中显示的文本。 |
|
连接文本 |
读取/写入 |
控件正在连接时在控件中显示的文本。 |
|
DesktopHeight |
读取/写入 |
当前控件在初始远程桌面上的高度（以像素为单位）。 |
|
DesktopWidth |
读取/写入 |
初始远程桌面上当前控件的宽度（以像素为单位）。 |
|
DisconnectedText |
读取/写入 |
终止连接之前在 控件中显示的文本。 |
|
域 |
读取/写入 |
当前用户登录到的域。 |
|
ExtendedDisconnectReason |
只读 |
有关客户端控件断开连接原因的扩展信息。 |
|
全屏 |
读取/写入 |
指示控件是否处于全屏模式。 |
|
FullScreenTitle |
只写 |
控件处于全屏模式时显示的窗口标题。 |
|
HorizontalScrollBarVisible |
只读 |
指示控件是否显示水平滚动条。 |
|
PortablePassword |
读取/写入 |
不支持此属性。 |
|
PortableSalt |
读取/写入 |
不支持此属性。 |
|
SecuredSettings |
只读 |
IMsTscSecuredSettings 接口指针。 |
|
SecuredSettings2 |
只读 |
指向 IMsRdpClientSecuredSettings 接口的 指针，用于设置客户端控件的安全设置。 |
|
SecuredSettingsEnabled |
只读 |
指示 IMsTscSecuredSettings 接口是否可用。 |
|
服务器 |
读取/写入 |
当前控件连接到的服务器的名称。 |
|
StartConnected |
读取/写入 |
指示控件是否会在启动时立即建立 RD 会话主机服务器连接。 |
|
用户 |
读取/写入 |
用户名登录凭据。 |
|
版本 |
只读 |
当前控件的版本号。 |
|
VerticalScrollBarVisible |
只读 |
指示控件是否显示垂直滚动条。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 类型库 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient3定义为 7584C670-2274-4EFB-B00B-D6AABA6D3850 |