CHANNEL_DEF (Windows Embedded CE 6.0)
1/6/2010
This structure contains the name and options of a virtual channel. A client DLL uses this structure when it calls VirtualChannelInit 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
Null-terminated string containing the name of a virtual channel. Virtual channel names can contain from 1 to CHANNEL_NAME_LEN characters.
options
Specifies the options for this virtual channel. The following table shows the possible values, which can be used in combination.Value Description CHANNEL_OPTION_ENCRYPT_CS
Encrypt client-to-server data.
CHANNEL_OPTION_ENCRYPT_RDP
Encrypt according to Remote Desktop Protocol (RDP) data encryption. That is, if RDP data is encrypted, do so for this channel, too.
CHANNEL_OPTION_INITIALIZED
The channel is initialized. This value is set by the VirtualChannelInit function.
CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT
The channel is declared as remote control persistent. This means that the channel will not be closed on the server side when a session is started that shadows the current session, or when the remote control connects to or disconnects from the session connected to the client. For more information, see Remote-Control Persistent Virtual Channels.
CHANNEL_OPTION_SHOW_PROTOCOL
Affects how data sent by VirtualChannelWrite 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_COMPRESS
Reserved for future use.
CHANNEL_OPTION_COMPRESS_RDP
Reserved for future use.
CHANNEL_OPTION_ENCRYPT_SC
Reserved for future use.
CHANNEL_OPTION_PRI_HIGH
Reserved for future use.
CHANNEL_OPTION_PRI_LOW
Reserved for future use.
CHANNEL_OPTION_PRI_MED
Reserved for future use.
Requirements
| Header | pchannel.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |