MsRdpClient3a 类
Microsoft RDP 客户端控制 (可再发行) - 版本 4a
此类实现以下接口。
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
MsRdpClient3a 具有以下类型的成员：
方法
MsRdpClient3a 类具有这些方法。
| 方法 | 说明 |
|---|---|
| 连接 | 使用控件上当前设置的属性启动连接。 |
| CreateVirtualChannels | 为每个指定的虚拟通道名称创建客户端虚拟通道对象。 |
| 断开 | 断开活动连接。 |
| GetVirtualChannelOptions | 检索为虚拟通道设置的选项。 |
| NotifyRedirectDeviceChange | 通知远程桌面ActiveX控件的设备重定向模块，指出系统上发生了设备更改。 此方法 将WM_DEVICECHANGE 通知传递给控件。 |
| OnAuthenticationWarningDismissed | ActiveX控件后调用的身份验证对话框 (例如证书错误对话框) 。 |
| OnAuthenticationWarningDisplayed | ActiveX控件之前调用的身份验证对话框 (例如证书错误对话框) 。 |
| OnAutoReconnected | 当客户端控件自动重新连接到远程会话时调用。 |
| OnAutoReconnecting | 当客户端在自动与 RD 会话主机服务器重新连接会话的过程中调用。 |
| OnAutoReconnecting2 | 当客户端在自动与 RD 会话主机服务器重新连接会话的过程中调用。 |
| OnChannelReceivedData | 客户端在可编写脚本的虚拟通道上接收数据时调用。 |
| OnConfirmClose | 客户端调用 IMsRdpClient：：RequestClose 方法时调用。 |
| OnConnected | 客户端控件在与 RD 会话主机服务器建立连接的过程中调用。 |
| OnConnecting | 当客户端控件开始连接到服务器以响应对 IMsTscAx：：连接 的调用时调用。 |
| 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 | 设置客户端控件的虚拟通道选项。 |
属性
MsRdpClient3a 类具有这些属性。
| properties | 访问类型 | 说明 |
|---|---|---|
|
AdvancedSettings |
只读 |
IMsTscAdvancedSettings 接口指针。 |
|
AdvancedSettings2 |
只读 |
指向 IMsRdpClientAdvancedSettings 接口的指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings3 |
只读 |
指向 IMsRdpClientAdvancedSettings2 接口的指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings4 |
只读 |
指向 IMsRdpClientAdvancedSettings3 接口的指针，用于设置客户端控件的高级设置。 |
|
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 会话主机服务器连接。 |
|
用户 |
读取/写入 |
用户名登录凭据。 |
|
版本 |
只读 |
当前控件的版本号。 |
|
VerticalScrollBarVisible |
只读 |
指示控件是否显示垂直滚动条。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 类型库 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient3a定义为 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 |