Share via

CHANNEL_DEF

  • Article

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.

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 characters.
  • options
    Specifies the options for this virtual channel. The following table shows the possible values that 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 when a 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

RDP Structures

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.