Partager via


Application de serveur de canal virtuel

Le module serveur d’une application qui utilise des canaux virtuels doit être une application en mode utilisateur s’exécutant dans une session cliente sur le serveur hôte de session Bureau à distance (hôte de session Bureau à distance). Notez que vous devez fournir une méthode pour démarrer l’application serveur. Vous pouvez effectuer cette opération de plusieurs manières ; Par exemple, vous pouvez utiliser un script d’ouverture de session, un programme ou un script dans le dossier De démarrage. Les utilisateurs peuvent également lancer l’application.

Vous devez stocker le nom de l’application de serveur de canal virtuel dans le Registre en ajoutant une sous-clé sous l’emplacement suivant :

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Terminal Server\Addins

Pour plus d’informations sur la sous-clé, consultez Monitoring Session Connections and Disconnections.

L’application serveur peut appeler la fonction WTSVirtualChannelOpen pour ouvrir un handle sur un canal virtuel. L’application peut ensuite utiliser le handle dans l’une des fonctions suivantes.

WTSVirtualChannelClose

Ferme un handle de canal virtuel ouvert.

WTSVirtualChannelPurgeInput

Supprime toutes les données d’entrée en file d’attente envoyées du client au serveur sur un canal virtuel spécifique.

Note

Cette fonction n’est actuellement pas utilisée par les services Bureau à distance.

 

WTSVirtualChannelPurgeOutput

Supprime toutes les données de sortie mises en file d’attente envoyées du serveur au client sur un canal virtuel spécifique.

Note

Cette fonction n’est actuellement pas utilisée par les services Bureau à distance.

 

WTSVirtualChannelQuery

Retourne des informations sur un canal virtuel spécifié.

WTSVirtualChannelRead

Lit les données à partir de la fin du serveur d’un canal virtuel.

WTSVirtualChannelWrite

Écrit des données à la fin du serveur d’un canal virtuel.