MsRdpClient2 类
Microsoft RDP 客户端控制 (可再发行) - 版本 3
此类实现以下接口。
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
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 |
类型库 |
|
DLL |
|
CLSID |
CLSID_MsRdpClient2定义为 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A |