MsRdpClient 類別
Microsoft RDP 用戶端控制 (可轉散發) - 第 2 版
這個類別會實作下列介面。
MsRdpClient 有下列類型的成員：
方法
MsRdpClient類別具有這些方法。
| 方法 | Description |
|---|---|
| 連線 | 使用控制項上目前設定的屬性來起始連接。 |
| 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 | 當用戶端控制項成功登入 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 工作階段主機伺服器。 |
| SetVirtualChannelOptions | 設定用戶端控制項的虛擬通道選項。 |
屬性
MsRdpClient類別具有這些屬性。
| 屬性 | 存取類型 | Description |
|---|---|---|
|
AdvancedSettings |
唯讀 |
IMsTscAdvancedSettings介面指標。 |
|
AdvancedSettings2 |
唯讀 |
IMsRdpClientAdvancedSettings介面的指標，用來設定用戶端控制項的進階設定。 |
|
BinaryPassword |
讀取/寫入 |
不支援這個屬性。 |
|
BinarySalt |
讀取/寫入 |
不支援這個屬性。 |
|
CipherStrength |
唯讀 |
目前控制項的最大加密強度。 |
|
ClearTextPassword |
僅限寫入 |
遠端桌面 ActiveX 控制密碼，格式為純文字。 |
|
ColorDepth |
讀取/寫入 |
目前控制項的色彩深度。 |
|
連線 |
唯讀 |
目前控制項的連接狀態。 |
|
ConnectingText |
讀取/寫入 |
控制項連接時，出現在 控制項中置中的文字。 |
|
DesktopHeight |
讀取/寫入 |
目前控制項在初始遠端桌面上的高度，以圖元為單位。 |
|
DesktopWidth |
讀取/寫入 |
目前控制項在初始遠端桌面上的寬度，以圖元為單位。 |
|
DisconnectedText |
讀取/寫入 |
在終止連接之前，出現在 控制項中置中的文字。 |
|
網域 |
讀取/寫入 |
目前使用者登入的網域。 |
|
ExtendedDisconnectReason |
唯讀 |
有關中斷連線之用戶端控制項原因的擴充資訊。 |
|
FullScreen |
讀取/寫入 |
指出控制項是否處於全螢幕模式。 |
|
FullScreenTitle |
僅限寫入 |
當控制項處於全螢幕模式時，所顯示的視窗標題。 |
|
HorizontalScrollBarVisible |
唯讀 |
指出控制項是否顯示水準捲軸。 |
|
PortablePassword |
讀取/寫入 |
不支援這個屬性。 |
|
PortableSalt |
讀取/寫入 |
不支援這個屬性。 |
|
SecuredSettings |
唯讀 |
IMsTscSecuredSettings介面指標。 |
|
SecuredSettings2 |
唯讀 |
IMsRdpClientSecuredSettings介面的指標，用來設定用戶端控制項的安全設定。 |
|
SecuredSettingsEnabled |
唯讀 |
指出 IMsTscSecuredSettings 介面是否可用。 |
|
伺服器 |
讀取/寫入 |
目前控制項所連接之伺服器的名稱。 |
|
StartConnected |
讀取/寫入 |
指出控制項是否會在啟動時立即建立 RD 工作階段主機伺服器連線。 |
|
使用者 |
讀取/寫入 |
使用者名稱登入認證。 |
|
版本 |
唯讀 |
目前控制項的版本號碼。 |
|
VerticalScrollBarVisible |
唯讀 |
指出控制項是否顯示垂直捲動條。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 類型程式庫 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient定義為 791fa017-2de3-492e-acc5-53c67a2b94d0 |