Partager via


CHANNEL_DEF (Windows CE 5.0)

Send Feedback

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

RDP Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.