Share via

CHANNEL_DEF (Windows Embedded CE 6.0)

  • Article

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

See Also

Reference

RDP Structures