IWRdsProtocolConnection::CreateVirtualChannel method (wtsprotocol.h)

Requests that the protocol create a virtual channel.


HRESULT CreateVirtualChannel(
  [in]  CHAR      *szEndpointName,
  [in]  BOOL      bStatic,
  [in]  ULONG     RequestedPriority,
  [out] ULONG_PTR *phChannel


[in] szEndpointName

A null-terminated string that contains the endpoint data that uniquely identifies the connection.

[in] bStatic

Specifies whether the virtual channel is static or dynamic.


The channel is static.


The channel is dynamic.

[in] RequestedPriority

Specifies the requested priority for the channel.

[out] phChannel

A pointer to a ULONG value that receives the handle for the channel created.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.


Virtual channels are software extensions that can be created to enhance a Remote Desktop Services application. Examples include support for additional hardware or additions to the functionality provided by a given protocol. For more information, see Remote Desktop Services Virtual Channels.


Minimum supported client None supported
Minimum supported server Windows Server 2012
Target Platform Windows
Header wtsprotocol.h

See also