CHANNEL_DEF (Windows CE 5.0)
This structure contains the name and options of a virtual channel. A client DLL uses this structure when it calls VirtualChannelInit or VirtualChannelInitEx to register a virtual channel name.
typedef struct tagCHANNEL_DEF {charname[CHANNEL_NAME_LEN + 1];ULONGoptions;} 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 or VirtualChannelInitEx 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
OS Versions: Windows CE .NET 4.0 and later.
Header: Pchannel.h.
See Also
Send Feedback on this topic to the authors