MsRdpClient3NotSafeForScripting 类
Microsoft RDP 客户端控制 - 版本 4
此类实现以下接口。
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
MsRdpClient3NotSafeForScripting 具有以下类型的成员：
方法
MsRdpClient3NotSafeForScripting 类包含以下方法。
| 方法 | 说明 |
|---|---|
| 连接 | 使用控件上当前设置的属性启动连接。 |
| 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 | 设置客户端控件的虚拟通道选项。 |
属性
MsRdpClient3NotSafeForScripting 类具有以下属性。
| 属性 | 访问类型 | 说明 |
|---|---|---|
|
AdvancedSettings |
只读 |
IMsTscAdvancedSettings 接口指针。 |
|
AdvancedSettings2 |
只读 |
指向 IMsRdpClientAdvancedSettings 接口的 指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings3 |
只读 |
指向 IMsRdpClientAdvancedSettings2 接口的指针，用于设置客户端控件的高级设置。 |
|
AdvancedSettings4 |
只读 |
指向 IMsRdpClientAdvancedSettings3 接口的指针，用于设置客户端控件的高级设置。 |
|
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_MsRdpClient3NotSafeForScripting定义为 ACE575FD-1FCF-4074-9401-EBAB990FA9DE |