Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CHANNEL_DEF

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.

ValueMeaning
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 2003

Header

Pchannel.h

See also

VirtualChannelInit
VirtualChannelWrite

 

 

Show:
© 2015 Microsoft