Virtual Channel Server Application

The server module of an application that uses virtual channels must be a user-mode application running in a client session on the Remote Desktop Session Host (RD Session Host) server. Note that you must provide a method to start the server application. You can accomplish this in multiple ways; for example, you can use a logon script, or a program or script in the Startup folder. Users could also launch the application.

You must store the name of the virtual channel server application in the registry by adding a subkey under the following location:

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

For more information about the subkey, see Monitoring Session Connections and Disconnections.

The server application can call the WTSVirtualChannelOpen function to open a handle to a virtual channel. The application can then use the handle in any of the following functions.

WTSVirtualChannelClose

Closes an open virtual channel handle.

WTSVirtualChannelPurgeInput

Deletes all queued input data sent from the client to the server on a specific virtual channel.

Note

This function currently is not used by Remote Desktop Services.

 

WTSVirtualChannelPurgeOutput

Deletes all queued output data sent from the server to the client on a specific virtual channel.

Note

This function currently is not used by Remote Desktop Services.

 

WTSVirtualChannelQuery

Returns information about a specified virtual channel.

WTSVirtualChannelRead

Reads data from the server end of a virtual channel.

WTSVirtualChannelWrite

Writes data to the server end of a virtual channel.