IWRdsProtocolConnection::CreateVirtualChannel method (wtsprotocol.h)

Requests that the protocol create a virtual channel.

Syntax

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

Parameters

[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.

TRUE

The channel is static.

FALSE

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.

Remarks

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.

Requirements

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

See also

IWRdsProtocolConnection