IMsRdpClient9 介面

提供設定及使用用戶端控制項所需的方法和屬性。 衍生自 IMsRdpClient8 介面。

成員

IMsRdpClient9介面繼承自IMsRdpClient8。 IMsRdpClient9 也有下列類型的成員：

• 方法
• 屬性

方法

IMsRdpClient9介面具有這些方法。

方法	描述
attachEvent	附加事件。
連接	使用控制項上目前設定的屬性來起始連接。
CreateVirtualChannels	為每個指定的虛擬通道名稱建立用戶端虛擬通道物件。
detachEvent	中斷連結事件。
中斷連線	中斷使用中連線。
GetErrorDescription	擷取會話中斷線上活動的錯誤描述。
GetStatusText	擷取指定狀態碼的狀態文字。
GetVirtualChannelOptions	擷取虛擬通道所設定的選項。
重新連接	使用新的桌面寬度和高度重新連線到遠端會話。
RequestClose	要求遠端桌面 ActiveX 控制項的正常關機。
SendOnVirtualChannel	透過先前使用 CreateVirtualChannels 方法建立的虛擬通道，將資料傳送至 RD 工作階段主機伺服器。
SendRemoteAction	導致在遠端會話中執行動作。
SetVirtualChannelOptions	設定遠端桌面 ActiveX 控制項的虛擬通道選項。
SyncSessionDisplaySettings	同步處理會話顯示設定。
UpdateSessionDisplaySettings	更新會話顯示設定。

屬性

IMsRdpClient9介面具有這些屬性。

屬性	存取類型	描述
AdvancedSettings	唯讀	擷取 IMsTscAdvancedSettings 介面指標。
AdvancedSettings2	唯讀	擷取 IMsRdpClientAdvancedSettings 介面的指標。 介面可用來設定用戶端控制項的進階設定。
AdvancedSettings3	唯讀	擷取 IMsRdpClientAdvancedSettings2 介面的指標。 介面可用來設定用戶端控制項的進階設定。
AdvancedSettings4	唯讀	擷取 IMsRdpClientAdvancedSettings3 介面的指標。
AdvancedSettings5	唯讀	擷取 IMsRdpClientAdvancedSettings4 介面的指標。
AdvancedSettings6	唯讀	擷取 IMsRdpClientAdvancedSettings5 介面。
AdvancedSettings7	唯讀	擷取 IMsRdpClientAdvancedSettings6 介面。
AdvancedSettings8	唯讀	擷取支援 IMsRdpClientAdvancedSettings7 介面的物件。
AdvancedSettings9	唯讀	包含支援 IMsRdpClientAdvancedSettings8 介面的物件。
CipherStrength	唯讀	擷取目前控制項的最大加密強度。
ColorDepth	讀取/寫入	控制項連接的每個圖元) (色彩深度) 。
連線	唯讀	擷取目前控制項的連接狀態。
ConnectedStatusText	讀取/寫入	包含控制項處於連接狀態時，控制項工作區中顯示的文字。
ConnectingText	讀取/寫入	指定在控制項連接時，出現在 控制項中置中的文字。
DesktopHeight	讀取/寫入	指定初始遠端桌面上目前控制項的高度，以圖元為單位。
DesktopWidth	讀取/寫入	指定初始遠端桌面上目前控制項的寬度，以圖元為單位。
DisconnectedText	讀取/寫入	指定在終止連接之前，出現在 控制項中置中的文字。
網域	讀取/寫入	指定目前使用者登入的網域。
ExtendedDisconnectReason	唯讀	包含控制項中斷連線原因的擴充資訊。
FullScreen	讀取/寫入	判斷用戶端控制項是否處於全螢幕模式。
FullScreenTitle	僅限寫入	指定當控制項處於全螢幕模式時所顯示的視窗標題。
HorizontalScrollBarVisible	唯讀	指出控制項是否顯示水準捲軸。
MsRdpClientShell	唯讀	擷取可編寫腳本的用戶端設定介面 IMsRdpClientShell。
RemoteProgram	唯讀	擷 取支援 ITSRemoteProgram 介面的物件。
RemoteProgram2	唯讀	擷 取支援 ITSRemoteProgram2 介面的物件。
SecuredSettings	唯讀	擷取 IMsTscSecuredSettings 介面指標。
SecuredSettings2	唯讀	擷取 IMsRdpClientSecuredSettings 介面的指標。 這個介面可用來設定用戶端控制項的安全設定。
SecuredSettings3	唯讀	擷取支援 IMsRdpClientSecuredSettings2 介面的物件。
SecuredSettingsEnabled	唯讀	指出 IMsTscSecuredSettings 介面是否可用。 也就是說，包含控制項的網頁目前是否位於其中一個允許的 Internet Explorer URL 安全性區域中。
伺服器	讀取/寫入	指定目前控制項所連接之伺服器的名稱。
StartConnected	讀取/寫入	指出控制項是否會在啟動時立即建立 RD 工作階段主機伺服器連線。
TransportSettings	唯讀	擷取透過腳本傳遞至 IMsRdpClientTransportSettings 介面的內容。
TransportSettings2	唯讀	擷取 IMsRdpClientTransportSettings2 介面。
TransportSettings3	唯讀	擷取支援 IMsRdpClientTransportSettings3 介面的物件。
TransportSettings4	唯讀	擷取支援 IMsRdpClientTransportSettings4 介面的物件。
使用者	讀取/寫入	指定使用者名稱登入認證。
版本	唯讀	指定目前控制項的版本號碼。
VerticalScrollBarVisible	唯讀	指出控制項是否顯示垂直捲動條。

備註

IMsRdpClient9介面已由下列介面擴充，每個新介面都會繼承先前介面的所有方法和屬性：

• IMsRdpClient10

如需遠端桌面 Web 連線的詳細資訊，請參閱 遠端桌面 Web 連線的需求。

規格需求

需求	值
最低支援的用戶端	Windows 8.1
最低支援的伺服器	Windows Server 2012 R2
類型程式庫	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient10定義為 C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting定義為 A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient9定義為 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting定義為 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID	IID_IMsRdpClient9定義為 28904001-04B6-436C-A55B-0AF1A0883DC9

另請參閱

IMsRdpClient8

IMsRdpClient7

IMsRdpClient6

IMsRdpClient5

IMsRdpClient4

IMsRdpClient3

IMsRdpClient2

IMsRdpClient

IMsTscAx

遠端桌面 Web 連線參考