Virtual Channel Server Application
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
The server part of a client/server application that uses virtual channels must be a user-mode application that is running in a client session on the Terminal Server. After a user has logged on to a server that runs Terminal Services, the user must be able to start the virtual channel server application to execute its unique functionality. There are several ways to do this, such as a logon script, a program, or a script in the Startup folder. Or, the user can start the application manually.
You must store the name of the virtual channel server application in the registry by adding a subkey in the following location.
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TerminalServer\Addins
For more information about this subkey, see Virtual Channel Server Registration.
The server application calls WTSVirtualChannelOpen to obtain a handle to a virtual channel. The server application can then use that handle to call any of the Terminal Server functions shown in the following table.
| Function | Description |
|---|---|
WTSVirtualChannelClose |
Closes an open virtual channel handle. |
WTSVirtualChannelPurgeInput |
Purges all queued input data sent from the client to the server on a specific virtual channel. |
WTSVirtualChannelPurgeOutput |
Purges all queued output data sent from the server to the client on a specific virtual channel. |
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. |
For more information about these functions, see this Microsoft Web site.