Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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