MsRdpClient12 類別

Microsoft RDP 用戶端控制 (可轉散發) - 版本 13

這個類別會實作下列介面。

• IMsRdpClient10
• IMsRdpClient9
• IMsRdpClient8
• IMsRdpClient7
• IMsRdpClient6
• IMsRdpClient5
• IMsRdpClient4
• IMsRdpClient3
• IMsRdpClient2
• IMsRdpClient
• IMsTscAx
• IDispatch
• IMsTscAxEvents
• IMsTscNonScriptable
• IMsRdpClientNonScriptable
• IMsRdpClientNonScriptable2
• IMsRdpClientNonScriptable3
• IMsRdpClientNonScriptable4
• IMsRdpClientNonScriptable5
• IMsRdpClientNonScriptable6
• IMsRdpClientNonScriptable7
• IMsRdpClientNonScriptable8
• IMsRdpPreferredRedirectionInfo

MsRdpClient12 具有下列類型的成員：

• 方法
• 屬性

方法

MsRdpClient12類別具有這些方法。

方法	Description
attachEvent	附加事件。
連線	使用控制項上目前設定的屬性來起始連接。
CreateVirtualChannels	為每個指定的虛擬通道名稱建立用戶端虛擬通道物件。
detachEvent	中斷連結事件。
中斷連線	中斷使用中連線。
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	當用戶端控制項成功登入 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	透過先前使用 IMsTscAx：：CreateVirtualChannels 方法建立的虛擬通道，將資料傳送至 RD 工作階段主機伺服器。
SendRemoteAction	導致遠端會話中執行動作。
SetVirtualChannelOptions	設定用戶端控制項的虛擬通道選項。
SyncSessionDisplaySettings	同步處理會話顯示設定。
UpdateSessionDisplaySettings	更新會話顯示設定。
SendLocation2D	將緯度和經度值傳送至伺服器，讓用戶端的地理位置可以反映在遠端會話中。
SendLocation3D	將緯度、經度和高度值傳送至伺服器，讓用戶端的地理位置可以反映在遠端會話中。
DisableDpiCursorScalingForProcess	停用從伺服器接收的滑鼠游標本機縮放比例，確保游標圖形正確轉譯，而不需修改。
StartWorkspaceExtension	使用 RemoteApp 和桌面連線控制台來協調用戶端的遠端會話。

屬性

MsRdpClient12類別具有這些屬性。

屬性	存取類型	Description
AdvancedSettings	唯讀	IMsTscAdvancedSettings介面指標。
AdvancedSettings2	唯讀	IMsRdpClientAdvancedSettings介面的指標，用來設定用戶端控制項的進階設定。
AdvancedSettings3	唯讀	IMsRdpClientAdvancedSettings2介面的指標，用來設定用戶端控制項的進階設定。
AdvancedSettings4	唯讀	IMsRdpClientAdvancedSettings3介面的指標，用來設定用戶端控制項的進階設定。
AdvancedSettings5	唯讀	IMsRdpClientAdvancedSettings4介面指標。
AdvancedSettings6	唯讀	IMsRdpClientAdvancedSettings5 的介面。
AdvancedSettings7	唯讀	IMsRdpClientAdvancedSettings6 的介面。
AdvancedSettings8	唯讀	支援 IMsRdpClientAdvancedSettings7 介面的物件。
AdvancedSettings9	唯讀	代表設定物件的 IMsRdpClientAdvancedSettings8 介面。
AllowCredentialSaving	讀取/寫入	指定認證對話方塊是否顯示覆選框，以啟用儲存認證。
AllowPromptingForCredentials	讀取/寫入	指定遠端桌面 ActiveX 控制項是否可以提示使用者輸入認證。
BinaryPassword	讀取/寫入	不支援這個屬性。
BinarySalt	讀取/寫入	不支援這個屬性。
CipherStrength	唯讀	目前控制項的最大加密強度。
ClearTextPassword	僅限寫入	遠端桌面 ActiveX 控制密碼，純文字格式。
ColorDepth	讀取/寫入	目前控制項的色彩深度。
已連線	唯讀	目前控制項的連接狀態。
ConnectedStatusText	讀取/寫入	控制項處於已連接狀態時，顯示在 控制項的工作區中的文字。
ConnectingText	讀取/寫入	控制項連接時，出現在控制項中置中的文字。
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	唯讀	入口網站啟動器的用戶端設定。
NegotiateSecurityLayer	讀取/寫入	指定此連線是否支援 NegotiateSecurityLayer 設定。 注意： 啟用 CredSspSupport 並在用戶端上出現時，或當安全通訊端層 (SSL) 啟用使用者驗證時，會忽略 NegotiateSecurityLayer。
PortablePassword	讀取/寫入	不支援這個屬性。
PortableSalt	讀取/寫入	不支援這個屬性。
PromptForCredentials	讀取/寫入	指定是否應該顯示 [輸入認證] 對話方塊的提示。
PromptForCredsOnClient	讀取/寫入	指定用戶端控制項是否顯示提示輸入認證的對話方塊。
PublisherCertificateChain	讀取/寫入	指定發行者憑證鏈結。 鏈結會儲存在類型VT_BYREF的變體中，其中包含 CERT_CHAIN_CONTEXT 結構的指標。
RedirectDynamicDevices	讀取/寫入	指定是否可在會話中重新導向時列舉動態連結的 PnP 裝置。
RedirectDynamicDrives	讀取/寫入	指定會話中是否提供重新導向時列舉的動態連結 PnP 磁片磁碟機。
RedirectionWarningType	讀取/寫入	控制重新導向對話方塊的存在和外觀。
RemoteMonitorCount	唯讀	指定遠端監視器的數目。
RemoteMonitorLayoutMatchesLocal	唯讀	指定遠端監視器配置是否與本機監視器配置相同。
RemoteProgram	唯讀	用戶端 RemoteApp 設定。
RemoteProgram2	唯讀	支援 ITSRemoteProgram2 介面的物件。
RemoteProgram3	唯讀	支援 ITSRemoteProgram3 介面的物件。
SecuredSettings	唯讀	IMsTscSecuredSettings介面指標。
SecuredSettings2	唯讀	IMsRdpClientSecuredSettings介面的指標，用來設定用戶端控制項的安全設定。
SecuredSettings3	唯讀	支援 IMsRdpClientSecuredSettings2 介面的物件。
SecuredSettingsEnabled	唯讀	指出 IMsTscSecuredSettings 介面是否可用。
伺服器	讀取/寫入	目前控制項所連接之伺服器的名稱。
ShowRedirectionWarningDialog	讀取/寫入	指定是否應該在啟動會話之前顯示重新導向安全性警告對話方塊。
StartConnected	讀取/寫入	指出控制項是否會在啟動時立即建立 RD 工作階段主機伺服器連線。
TransportSettings	唯讀	用戶端 RD 閘道設定。
TransportSettings2	唯讀	IMsRdpClientTransportSettings2的介面。
TransportSettings3	唯讀	支援 IMsRdpClientTransportSettings3 介面的物件。
TransportSettings4	唯讀	支援 IMsRdpClientTransportSettings4 介面的物件。
TrustedZoneSite	讀取/寫入	指定使用者啟動連線的網站是否位於用戶端電腦的受信任網站清單中。
UIParentWindowHandle	讀取/寫入	做為控制項父視窗的視窗控制碼。 這可讓控制項所顯示的任何視窗在父應用程式所顯示的任何視窗上正確強制回應。
UseMultimon	讀取/寫入	指定遠端桌面 ActiveX 控制項是否應該使用多個監視器。
UseRedirectionServerName	讀取/寫入	是否要使用重新導向伺服器名稱。
使用者	讀取/寫入	使用者名稱登入認證。
版本	唯讀	目前控制項的版本號碼。
VerticalScrollBarVisible	唯讀	指出控制項是否顯示垂直捲動條。
WarnAboutClipboardRedirection	讀取/寫入	指定在啟動會話之前，安全性警告對話方塊是否應該包含剪貼簿重新導向的相關警告。
WarnAboutDirectXRedirection	讀取/寫入	不會使用此屬性。
WarnAboutPrinterRedirection	讀取/寫入	指定重新導向對話方塊是否在啟動會話之前顯示有關印表機重新導向的訊息。
WarnAboutSendingCredentials	讀取/寫入	指定在啟動會話之前，安全性警告是否應該包含有關將認證傳送至遠端伺服器的警告。
CameraRedirConfigCollection	唯讀	取得相機 (集合，以及可用於重新導向的相關聯組態) 。
剪貼簿	唯讀	取得啟用手動剪貼簿同步處理時，用來同步處理本機和遠端剪貼簿的剪貼簿控制器。
CorrelationId	唯讀	取得可唯一識別用戶端遠端會話的 GUID。
SupportsWorkspaceReconnect	僅限寫入	通知遠端桌面 ActiveX 控制項，用戶端的遠端會話是 RemoteApp 和 Desktop Connections 控制台中支援重新連線的一部分。

規格需求

需求	值
最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016
類型程式庫	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient12定義為 945EE98E-B376-4EC2-B2E5-64C9410F93B7

另請參閱

遠端桌面 ActiveX 控制項類別