RemoteTextConnection 類別

定義

命名空間:

Windows.System.RemoteDesktop.Input

表示遠端桌面用戶端應用程式與本機電腦文字輸入系統之間的連線。 此連線可用來啟用文字輸入虛擬化。

public ref class RemoteTextConnection sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.System.RemoteDesktop.Input.IRemoteTextConnectionFactory, 851968, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.System.RemoteDesktop.Input.IRemoteTextConnectionFactory2, 1048576, "Windows.Foundation.UniversalApiContract")]
class RemoteTextConnection final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.System.RemoteDesktop.Input.IRemoteTextConnectionFactory), 851968, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.System.RemoteDesktop.Input.IRemoteTextConnectionFactory2), 1048576, "Windows.Foundation.UniversalApiContract")]
public sealed class RemoteTextConnection : System.IDisposable

function RemoteTextConnection(connectionId, pduForwarder, options)

Public NotInheritable Class RemoteTextConnection
Implements IDisposable

繼承

Object Platform::Object IInspectable RemoteTextConnection

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable

Windows 需求

裝置系列	Windows 11 (已於 10.0.22000.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v14.0 引進)

備註

RemoteTextConnection 的設計目的是使用與本機桌面整合的遠端應用程式來啟用文字輸入虛擬化。 這個案例稱為 遠端程式 或 遠端應用程式整合本機 （RAIL）。 目前不建議使用 RemoteTextConnection 搭配完整桌面遠端處理，而且可能會導致不想要的行為。 啟用文字輸入虛擬化時，Windows 提供的內建輸入法可用於在遠端應用程式中輸入文字。

若要啟用文字輸入虛擬化，遠端桌面用戶端應用程式會針對它所連線的每個遠端會話建立一個 RemoteTextConnection 物件。 資料封包會透過這個物件來回傳遞至本機計算機的文字輸入系統，並透過下列方式傳送：

• 文字輸入系統會透過 RemoteTextConnectionDataHandler 委派，將數據封包傳送至遠端桌面用戶端應用程式。 遠端桌面用戶端應用程式負責建立此委派，並將它傳遞至 RemoteTextConnection 建構函式。 來自文字輸入系統的數據封包會符合 RDP 文字輸入虛擬化通訊協定。 在此委派上收到的訊息將會抵達背景線程。 當用戶端應用程式從委派接收數據封包時，它應該透過單向、用戶端對伺服器 動態虛擬通道 （DVC），將封包轉送至遠端RAIL伺服器，以進行虛擬化文字輸入。 此 DVC 名為 TextInput_ClientToServerDVC。

• 遠端桌面用戶端應用程式也需要透過 ReportDataReceived 方法，從伺服器對用戶端文字輸入 DVC 上的遠端電腦接聽數據封包（名為 TextInput_ServerToClientDVC），並將這些數據封包轉送至本機計算機的文字輸入系統。 如需遠端桌面用戶端應用程式如何支援 DVC 的詳細資訊，請參閱 動態虛擬通道 （DVC） 和 tsvirtualchannels.h 頭檔。

RemoteTextConnection 的唯一本機輸入方法會與遠端應用程式整合，是 Windows 提供的內建輸入法，其使用下一版的 Text Services Framework （包括 IME）。 這些輸入方法是由文字輸入系統在集中式程式中裝載，讓整合可行。 舊版文字服務架構第 1 版或 IMM IME 不會裝載在集中式程式中，而且文字輸入虛擬化不支援。 這些較舊的輸入方法必須直接安裝在遠端系統上，才能與從該系統遠端的應用程式搭配使用。 這與未使用文字輸入虛擬化時使用文字服務架構第 1 版和 IMM 輸入方法的方式相同。

建構函式

RemoteTextConnection(Guid, RemoteTextConnectionDataHandler, RemoteTextConnectionOptions)	表示遠端桌面用戶端應用程式與本機電腦文字輸入系統之間的連線。 此連線可用來啟用文字輸入虛擬化。
RemoteTextConnection(Guid, RemoteTextConnectionDataHandler)	建立 RemoteTextConnection 一個遠端會話專屬類別的新實例。

屬性

IsEnabled

指定此 RemoteTextConnection 實例所服務的遠端桌面連線是否啟用文字輸入虛擬化。

方法

Close()	關閉 RemoteTextConnection 物件。
Dispose()	執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。
RegisterThread(UInt32)	註冊遠端桌面用戶端應用程式將呈現遠端UI的線程。
ReportDataReceived(Byte[])	將透過 TextInput_ServerToClientDVC動態虛擬通道 （DVC） 接收的數據封包轉送至本機計算機的文字輸入服務。
ReportPredictedKeyEvent(UInt16, RemoteKeyEventAttributes)	表示遠端桌面用戶端應用程式與本機電腦文字輸入系統之間的連線。 此連線可用來啟用文字輸入虛擬化。
UnregisterThread(UInt32)	在清除時，或該線程不再裝載遠端 UI 時，取消註冊透過 RegisterThread 註冊的線程。

另請參閱

• 動態虛擬通道 （DVC）