MsRdpClient3 類別

  • 發行項

Microsoft RDP 用戶端控制 (可轉散發) - 第 4 版

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

MsRdpClient3 具有下列類型的成員：

方法

MsRdpClient3類別具有這些方法。

方法 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 設定用戶端控制項的虛擬通道選項。

屬性

MsRdpClient3類別具有這些屬性。

屬性 存取類型 Description
AdvancedSettings
 唯讀
 IMsTscAdvancedSettings介面指標。
AdvancedSettings2
 唯讀
 IMsRdpClientAdvancedSettings介面的指標，用來設定用戶端控制項的進階設定。
AdvancedSettings3
 唯讀
 IMsRdpClientAdvancedSettings2介面的指標，用來設定用戶端控制項的進階設定。
AdvancedSettings4
 唯讀
 IMsRdpClientAdvancedSettings3介面的指標，用來設定用戶端控制項的進階設定。
BinaryPassword
 讀取/寫入
 不支援這個屬性。
BinarySalt
 讀取/寫入
 不支援這個屬性。
CipherStrength
 唯讀
 目前控制項的最大加密強度。
ClearTextPassword
 僅限寫入
 遠端桌面 ActiveX 控制密碼，純文字格式。
ColorDepth
 讀取/寫入
 目前控制項的色彩深度。
連線
 唯讀
 目前控制項的連接狀態。
ConnectedStatusText
 讀取/寫入
 控制項處於已連接狀態時，顯示在 控制項的工作區中的文字。
ConnectingText
 讀取/寫入
 控制項連接時，出現在控制項中置中的文字。
DesktopHeight
 讀取/寫入
 目前控制項在初始遠端桌面上的高度，以圖元為單位。
DesktopWidth
 讀取/寫入
 目前控制項的初始遠端桌面寬度，以圖元為單位。
DisconnectedText
 讀取/寫入
 在終止連接之前，出現在 控制項中置中的文字。
網域
 讀取/寫入
 目前使用者登入的網域。
ExtendedDisconnectReason
 唯讀
 用戶端控制項中斷連線原因的擴充資訊。
FullScreen
 讀取/寫入
 指出控制項是否處於全螢幕模式。
FullScreenTitle
 僅限寫入
 當控制項處於全螢幕模式時所顯示的視窗標題。
HorizontalScrollBarVisible
 唯讀
 指出控制項是否已顯示水準捲軸。
PortablePassword
 讀取/寫入
 不支援這個屬性。
PortableSalt
 讀取/寫入
 不支援這個屬性。
SecuredSettings
 唯讀
 IMsTscSecuredSettings介面指標。
SecuredSettings2
 唯讀
 IMsRdpClientSecuredSettings介面的指標，用來設定用戶端控制項的安全設定。
SecuredSettingsEnabled
 唯讀
 指出 IMsTscSecuredSettings 介面是否可用。
伺服器
 讀取/寫入
 目前控制項所連接之伺服器的名稱。
StartConnected
 讀取/寫入
 指出控制項是否會在啟動時立即建立 RD 工作階段主機伺服器連線。
使用者
 讀取/寫入
 使用者名稱登入認證。
版本
 唯讀
 目前控制項的版本號碼。
VerticalScrollBarVisible
 唯讀
 指出控制項是否顯示垂直捲動條。

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
類型程式庫
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
 CLSID_MsRdpClient3定義為 7584C670-2274-4EFB-B00B-D6AABA6D3850

另請參閱

遠端桌面 ActiveX 控制項類別