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

See also

IWRdsProtocolConnection