Microsoft RDP 用戶端控制 - 第 10 版
這個類別會實作下列介面。
- IMsRdpClient9
- IMsRdpClient8
- IMsRdpClient7
- IMsRdpClient6
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
- IMsRdpClientNonScriptable4
- IMsRdpClientNonScriptable5
- IMsRdpPreferredRedirectionInfo
- IMsRdpExtendedSettings
MsRdpClient9NotSafeForScripting 具有下列類型的成員：
方法
MsRdpClient9NotSafeForScripting類別具有這些方法。
| 方法 | 描述 |
|---|---|
| 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 | 更新會話顯示設定。 |
屬性
MsRdpClient9NotSafeForScripting類別具有這些屬性。
| 屬性 | 存取類型 | 描述 |
|---|---|---|
|
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 介面的物件。 |
|
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 |
讀取/寫入 |
指定在啟動會話之前，安全性警告是否應該包含有關將認證傳送至遠端伺服器的警告。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8.1 |
| 最低支援的伺服器 |
Windows Server 2012 R2 |
| 類型程式庫 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient9NotSafeForScripting定義為 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |