RemoteTextConnection Classe

Définition

Espace de noms:

Windows.System.RemoteDesktop.Input

Représente une connexion entre une application cliente Bureau à distance et le système d’entrée de texte de l’ordinateur local. Cette connexion peut être utilisée pour activer la virtualisation d’entrée de texte.

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

Héritage

Object Platform::Object IInspectable RemoteTextConnection

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 11 (introduit dans 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v14.0)

Remarques

remoteTextConnection est conçu pour permettre la virtualisation d’entrée de texte avec des applications distantes intégrées à un bureau local. Ce scénario est appelé programmes distants ou applications distantes intégrées localement (RAIL). L’utilisation de RemoteTextConnection avec la communication à distance de bureau complète n’est pas recommandée actuellement et peut entraîner un comportement indésirable. Lorsque la virtualisation d’entrée de texte est activée, les méthodes d’entrée intégrées fournies par Windows (y compris les imEs) peuvent être utilisées pour entrer du texte dans des applications distantes.

Pour activer la virtualisation d’entrée de texte, une application cliente Bureau à distance crée un objet RemoteTextConnection pour chaque session distante à laquelle il se connecte. Les paquets de données sont remis via cet objet vers et depuis le système d’entrée de texte de l’ordinateur local de la manière suivante :

• Le système d’entrée de texte envoie des paquets de données à l’application cliente Bureau à distance via le délégué RemoteTextConnectionDataHandler. L’application cliente Bureau à distance est chargée de créer ce délégué et de le transmettre au constructeur RemoteTextConnection. Les paquets de données du système d’entrée de texte sont conformes au protocole de virtualisation d’entrée de texte RDP. Les messages reçus sur ce délégué arrivent sur un thread d’arrière-plan. Lorsque l’application cliente reçoit des paquets de données du délégué, elle doit transférer les paquets au serveur RAIL distant via le de canal virtuel dynamique (DVC) unidirectionnel et unidirectionnel canal virtuel dynamique (DVC) pour l’entrée de texte virtualisée. Ce DVC est nommé TextInput_ClientToServerDVC.

• L’application cliente Bureau à distance doit également écouter les paquets de données de l’ordinateur distant sur l’entrée de texte serveur à client DVC (nommée TextInput_ServerToClientDVC) et transférer ces paquets de données au système d’entrée de texte de l’ordinateur local via la méthode ReportDataReceived. Pour plus d’informations sur la prise en charge des applications clientes Bureau à distance, consultez de canal virtuel dynamique (DVC) et le fichier d’en-tête tsvirtualchannels.h.

Les seules méthodes d’entrée locales qui RemoteTextConnection s’intègrent aux applications distantes sont des méthodes d’entrée intégrées fournies par Windows qui utilisent la prochaine version de l’infrastructure Text Services Framework (y compris les imEs). Ces méthodes d’entrée sont hébergées par le système d’entrée de texte dans un processus centralisé permettant l’intégration. Les anciennes imes Text Services Framework version 1 ou IMM ne sont pas hébergées dans un processus centralisé et ne sont pas prises en charge par la virtualisation d’entrée de texte. Ces anciennes méthodes d’entrée doivent être installées directement sur un système distant pour travailler avec les applications distantes de ce système. Il s’agit de la même façon que les méthodes d’entrée IMM version 1 et Text Services Framework sont utilisées lorsque la virtualisation d’entrée de texte n’est pas utilisée.

Constructeurs

RemoteTextConnection(Guid, RemoteTextConnectionDataHandler, RemoteTextConnectionOptions)	Représente une connexion entre une application cliente Bureau à distance et le système d’entrée de texte de l’ordinateur local. Cette connexion peut être utilisée pour activer la virtualisation d’entrée de texte.
RemoteTextConnection(Guid, RemoteTextConnectionDataHandler)	Crée une instance de la classe RemoteTextConnection spécifique à une session distante.

Propriétés

IsEnabled

Spécifie si la virtualisation d’entrée de texte est activée pour la connexion Bureau à distance serviceée par cette RemoteTextConnection instance.

Méthodes

Close()	Ferme l’objet RemoteTextConnection.
Dispose()	Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.
RegisterThread(UInt32)	Inscrit un thread sur lequel l’application cliente Bureau à distance présente l’interface utilisateur distante.
ReportDataReceived(Byte[])	Transfère un paquet de données reçu sur le TextInput_ServerToClientDVCcanal virtuel dynamique (DVC) au service d’entrée de texte de l’ordinateur local.
ReportPredictedKeyEvent(UInt16, RemoteKeyEventAttributes)	Représente une connexion entre une application cliente Bureau à distance et le système d’entrée de texte de l’ordinateur local. Cette connexion peut être utilisée pour activer la virtualisation d’entrée de texte.
UnregisterThread(UInt32)	Annule l’inscription d’un thread inscrit via RegisterThread lors du nettoyage ou lorsque ce thread n’hébergera plus l’interface utilisateur distante.

Voir aussi

• de canal virtuel dynamique (DVC)