CHANNEL_DEF structure

Contains the name and options of a Remote Desktop Services virtual channel. A client DLL uses this structure when it calls the VirtualChannelInit function to register a virtual channel name.

Syntax


typedef struct tagCHANNEL_DEF {
  char  name[CHANNEL_NAME_LEN + 1];
  ULONG options;
} CHANNEL_DEF, *PCHANNEL_DEF, **PPCHANNEL_DEF;

Members

name

A null-terminated string containing the name of a virtual channel. Virtual channel names can contain from 1 to CHANNEL_NAME_LEN (7) characters.

options

Specifies the options for this virtual channel. This member can be a combination of the following values.

CHANNEL_OPTION_INITIALIZED (0x80000000)

The channel is initialized. This value is set by the VirtualChannelInit function.

CHANNEL_OPTION_ENCRYPT_RDP (0x40000000)

Encrypt according to Remote Desktop Protocol (RDP) data encryption (that is, if RDP data is encrypted, do so for this channel, too).

CHANNEL_OPTION_ENCRYPT_SC (0x20000000)

Encrypt server-to-client data.

CHANNEL_OPTION_ENCRYPT_CS (0x10000000)

Encrypt client-to-server data.

CHANNEL_OPTION_PRI_HIGH (0x08000000)

Channel data should be sent with high Multipoint Communications Services (MCS) priority.

CHANNEL_OPTION_PRI_MED (0x04000000)

Channel data should be sent with medium MCS priority.

CHANNEL_OPTION_PRI_LOW (0x02000000)

Channel data should be sent with low MCS priority.

CHANNEL_OPTION_COMPRESS_RDP (0x00800000)

Virtual channel data should be compressed if RDP data is being compressed.

CHANNEL_OPTION_COMPRESS (0x00400000)

Virtual channel data should be compressed, regardless of Remote Desktop Protocol (RDP) compression.

CHANNEL_OPTION_SHOW_PROTOCOL (0x00200000)

Affects how data sent by the VirtualChannelWrite function is received at the server end. If this value is set, each data block is preceded by a CHANNEL_PDU_HEADER structure. If this value is not set, the data block includes only the data specified to VirtualChannelWrite.

CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT (0x00100000)

The channel is declared as remote control persistent. This means that the channel will not be closed when a remote control connects to or disconnects from the session connected to the client. For more information, see Remote Control Persistent Virtual Channels.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Pchannel.h

See also

VirtualChannelInit
VirtualChannelWrite

 

 

Show: