MsRdpClient7 类

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

此类实现以下接口。

• IMsRdpClient7
• IMsRdpClient6
• IMsRdpClient5
• IMsRdpClient4
• IMsRdpClient3
• IMsRdpClient2
• IMsRdpClient
• IMsTscAx
• IDispatch
• IMsTscAxEvents
• IMsTscNonScriptable
• IMsRdpClientNonScriptable
• IMsRdpClientNonScriptable2
• IMsRdpClientNonScriptable3
• IMsRdpClientNonScriptable4
• IMsRdpClientNonScriptable5
• IMsRdpPreferredRedirectionInfo

MsRdpClient7 具有以下类型的成员：

• 方法
• 属性

方法

MsRdpClient7 类具有这些方法。

方法	描述
连接	使用控件上当前设置的属性启动连接。
CreateVirtualChannels	为每个指定的虚拟通道名称创建客户端虚拟通道对象。
断开连接	断开活动连接。
GetErrorDescription	检索错误代码和错误消息。
GetStatusText	检索指定状态代码的状态文本。
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	设置客户端控件的虚拟通道选项。

属性

MsRdpClient7 类具有这些属性。

属性	访问类型	说明
AdvancedSettings	只读	IMsTscAdvancedSettings 接口指针。
AdvancedSettings2	只读	指向 IMsRdpClientAdvancedSettings 接口的 指针，用于设置客户端控件的高级设置。
AdvancedSettings3	只读	指向 IMsRdpClientAdvancedSettings2 接口的指针，用于设置客户端控件的高级设置。
AdvancedSettings4	只读	指向 IMsRdpClientAdvancedSettings3 接口的指针，用于设置客户端控件的高级设置。
AdvancedSettings5	只读	IMsRdpClientAdvancedSettings4 接口指针。
AdvancedSettings6	只读	IMsRdpClientAdvancedSettings5 的接口。
AdvancedSettings7	只读	IMsRdpClientAdvancedSettings6 的接口。
AdvancedSettings8	只读	支持 IMsRdpClientAdvancedSettings7 接口的 对象。
AllowCredentialSaving	读取/写入	指定凭据对话框是否显示检查框以启用凭据保存。
AllowPromptingForCredentials	读取/写入	指定远程桌面 ActiveX 控件是否可以提示用户输入凭据。
BinaryPassword	读取/写入	不支持此属性。
BinarySalt	读取/写入	不支持此属性。
CipherStrength	只读	当前控件的最大加密强度。
ClearTextPassword	只写	远程桌面 ActiveX 控制密码，采用纯文本格式。
ColorDepth	读取/写入	当前控件的颜色深度。
已连接	只读	当前控件的连接状态。
ConnectedStatusText	读取/写入	控件处于连接状态时在控件的工作区中显示的文本。
连接文本	读取/写入	控件正在连接时在控件中显示的文本。
ConnectionBarText	读取/写入	要为连接栏显示的文本字符串。
DesktopHeight	读取/写入	当前控件在初始远程桌面上的高度（以像素为单位）。
DesktopWidth	读取/写入	初始远程桌面上当前控件的宽度（以像素为单位）。
DeviceCollection	只读	可用于重定向的 PnP 设备的集合。
DisableConnectionBar	只写	指定远程桌面 ActiveX 控件是否应禁用连接栏。
DisableRemoteAppCapsCheck	读取/写入	指定远程桌面 ActiveX 控件是否不应检查服务器以获取 RemoteApp 功能。
DisconnectedText	读取/写入	终止连接之前在 控件中显示的文本。
域	读取/写入	当前用户登录到的域。
DriveCollection	只读	可用于重定向的磁盘驱动器的集合。
EnableCredSspSupport	读取/写入	指定是否为此连接启用 CredSSP。
ExtendedDisconnectReason	只读	有关客户端控件断开连接原因的扩展信息。
FullScreen	读取/写入	指示控件是否处于全屏模式。
FullScreenTitle	只写	控件处于全屏模式时显示的窗口标题。
GetRemoteMonitorsBoundingBox	只读	指定远程监视器的边框。
HorizontalScrollBarVisible	只读	指示控件是否显示水平滚动条。
LaunchedViaClientShellInterface	读取/写入	指定用户是否使用 RD Web 访问接口启动客户端控件。
MarkRdpSettingsSecure	读取/写入	指定是否将 RDP 设置标记为安全。
MsRdpClientShell	只读	Web 门户启动器的客户端设置。
NegotiateSecurityLayer	读取/写入	指定此连接是否支持 NegotiateSecurityLayer 设置。 注意： 启用 CredSspSupport 并在客户端上显示时，或者当通过用户身份验证启用安全套接字层 (SSL) 时，将忽略 NegotiateSecurityLayer。
PortablePassword	读取/写入	不支持此属性。
PortableSalt	读取/写入	不支持此属性。
PromptForCredentials	读取/写入	指定是否应显示“输入凭据”对话框的提示。
PromptForCredsOnClient	读取/写入	指定客户端控件是否显示提示输入凭据的对话框。
PublisherCertificateChain	读取/写入	指定发布者证书链。 链存储在包含指向 CERT_CHAIN_CONTEXT结构的指针 的 VT_BYREF 类型的变体中。
RedirectDynamicDevices	读取/写入	指定在会话中枚举的动态附加 PnP 设备是否可用于重定向。
RedirectDynamicDrives	读取/写入	指定在会话中枚举的动态附加 PnP 驱动器是否可用于重定向。
RedirectionWarningType	读取/写入	控制重定向对话框的状态和外观。
RemoteMonitorCount	只读	指定远程监视器的数量。
RemoteMonitorLayoutMatchesLocal	只读	指定远程监视器布局是否与本地监视器布局相同。
RemoteProgram	只读	客户端 RemoteApp 设置。
RemoteProgram2	只读	支持 ITSRemoteProgram2 接口的 对象。
SecuredSettings	只读	IMsTscSecuredSettings 接口指针。
SecuredSettings2	只读	指向 IMsRdpClientSecuredSettings 接口的 指针，用于设置客户端控件的安全设置。
SecuredSettings3	只读	支持 IMsRdpClientSecuredSettings2 接口的对象 。
SecuredSettingsEnabled	只读	指示 IMsTscSecuredSettings 接口是否可用。
Server	读取/写入	当前控件连接到的服务器的名称。
ShowRedirectionWarningDialog	读取/写入	指定在启动会话之前是否应显示重定向安全警告对话框。
StartConnected	读取/写入	指示控件是否会在启动时立即建立 RD 会话主机服务器连接。
TransportSettings	只读	客户端 RD 网关设置。
TransportSettings2	只读	IMsRdpClientTransportSettings2 的接口。
TransportSettings3	只读	支持 IMsRdpClientTransportSettings3 接口的 对象。
TrustedZoneSite	读取/写入	指定用户从中启动连接的网站是否位于客户端计算机的受信任站点列表中。
UIParentWindowHandle	读取/写入	控件的父窗口的窗口句柄。 这样，控件显示的任何窗口就父应用程序显示的任何窗口都可以正确模式化。
UseMultimon	读取/写入	指定远程桌面 ActiveX 控件是否应使用多个监视器。
UseRedirectionServerName	读取/写入	是否使用重定向服务器名称。
用户	读取/写入	用户名登录凭据。
版本	只读	当前控件的版本号。
VerticalScrollBarVisible	只读	指示控件是否显示垂直滚动条。
WarnAboutClipboardRedirection	读取/写入	指定在启动会话之前，安全警告对话框是否应包含有关剪贴板重定向的警告。
WarnAboutDirectXRedirection	读取/写入	不使用此属性。
WarnAboutPrinterRedirection	读取/写入	指定重定向对话框在启动会话之前是否显示有关打印机重定向的消息。
WarnAboutSendingCredentials	读取/写入	指定在启动会话之前，安全警告是否应包含有关向远程服务器发送凭据的警告。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
类型库	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7定义为 A9D7038D-B5ED-472E-9C47-94BEA90A5910

另请参阅

远程桌面 ActiveX 控件类