RemoteTextConnection Klasse

Definition

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)]
class RemoteTextConnection final : 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)]
public sealed class RemoteTextConnection : System.IDisposable

[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)

function RemoteTextConnection(connectionId, pduForwarder, options)

Public NotInheritable Class RemoteTextConnection
Implements IDisposable

Vererbung

Object Platform::Object IInspectable RemoteTextConnection

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Hinweise

RemoteTextConnection wurde entwickelt, um die Texteingabevirtualisierung mit Remoteanwendungen zu ermöglichen, die in einen lokalen Desktop integriert sind. Dieses Szenario wird remote programs oder Remote Applications Integrated Locally (RAIL)genannt. Die Verwendung von RemoteTextConnection- mit vollständigem Desktop-Remoting wird derzeit nicht empfohlen und kann zu unerwünschtem Verhalten führen. Wenn die Texteingabevirtualisierung aktiviert ist, können integrierte Eingabemethoden von Windows (einschließlich IMEs) zum Eingeben von Text in Remoteanwendungen verwendet werden.

Um die Texteingabevirtualisierung zu aktivieren, erstellt eine Remotedesktopclientanwendung ein RemoteTextConnection Objekt für jede Remotesitzung, mit der eine Verbindung hergestellt wird. Datenpakete werden über dieses Objekt an und vom Texteingabesystem des lokalen Computers auf folgende Weise übermittelt:

• Das Texteingabesystem sendet Datenpakete über den RemoteTextConnectionDataHandler Delegaten an die Remotedesktopclientanwendung. Die Remotedesktopclientanwendung ist für das Erstellen dieses Delegaten verantwortlich und übergibt sie an den RemoteTextConnection--Konstruktor. Die Datenpakete aus dem Texteingabesystem entsprechen dem RDP-Texteingabevirtualisierungsprotokoll. Auf dieser Stellvertretung empfangene Nachrichten werden in einem Hintergrundthread eingetroffen. Wenn die Clientanwendung Datenpakete von der Stellvertretung empfängt, sollte sie die Pakete über die unidirektionale, client-zu-Server-Dynamic Virtual Channel (DVC)- für die virtualisierte Texteingabe an den Remote-RAIL-Server weiterleiten. Dieser DVC wird TextInput_ClientToServerDVCbenannt.

• Die Remotedesktopclientanwendung muss auch auf Datenpakete vom Remotecomputer auf dem Server-zu-Client-Texteingabe-DVC (namens TextInput_ServerToClientDVC) lauschen und diese Datenpakete über die ReportDataReceived--Methode an das Texteingabesystem des lokalen Computers weiterleiten. Weitere Informationen dazu, wie Remotedesktopclientanwendungen DVCs unterstützen, finden Sie unter Dynamic Virtual Channel (DVC) und der Headerdatei tsvirtualchannels.h.

Die einzigen lokalen Eingabemethoden, die RemoteTextConnection- in Remoteanwendungen integriert werden, sind integrierte Eingabemethoden, die von Windows bereitgestellt werden, die die nächste Version des Text Services Framework (einschließlich IMEs) verwenden. Diese Eingabemethoden werden vom Texteingabesystem in einem zentralen Prozess gehostet, wodurch die Integration möglich ist. Ältere Text services Framework Version 1 oder IMM IMEs werden nicht in einem zentralisierten Prozess gehostet und werden von der Texteingabevirtualisierung nicht unterstützt. Diese älteren Eingabemethoden müssen direkt auf einem Remotesystem installiert werden, um mit Anwendungen zu arbeiten, die von diesem System entfernt wurden. Dies entspricht der Verwendung von Text Services Framework, Version 1 und IMM-Eingabemethoden, wenn die Texteingabevirtualisierung nicht verwendet wird.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Dynamic Virtual Channel (DVC)