CHANNEL_PDU_HEADER (Windows Embedded CE 6.0)

1/6/2010

This structure contains information about a data block being received by the server end of a virtual channel.

Syntax

typedef struct tagCHANNEL_PDU_HEADER {
  UINT32 length;
  UINT32 flags;
} CHANNEL_PDU_HEADER, *PCHANNEL_PDU_HEADER;

Members

  • length
    Size, in bytes, of the data block, excluding this header.
  • flags
    Information about the data block. The following table shows the bit flags that are set. Do not make direct comparisons using the == operator; use the methods described in this table to compare the corresponding flag value.

    Value Description

    CHANNEL_FLAG_FIRST

    The chunk is the beginning of the data written by a single write operation.

    Use bitwise comparisons when comparing this flag.

    CHANNEL_FLAG_LAST

    The chunk is the end of the data written by a single write operation.

    Use bitwise comparisons when comparing this flag.

    CHANNEL_FLAG_MIDDLE

    This is the default. The chunk is in the middle of a block of data written by a single write operation.

    Do not use bitwise comparisons to compare this flag value directly. Instead, use bitwise comparisons to determine that the flag value is not CHANNEL_FLAG_FIRST or CHANNEL_FLAG_LAST. This is done by using the following comparison: Result = !(flags & CHANNEL_FLAG_FIRST) && !(flags & CHANNEL_FLAG_LAST).

    CHANNEL_FLAG_ONLY

    Combines the CHANNEL_FLAG_FIRST and CHANNEL_FLAG_LAST values. The chunk contains all the data from a single write operation.

    Use bitwise comparisons when comparing this flag.

Remarks

This structure is used if the client DLL sets the CHANNEL_OPTION_SHOW_PROTOCOL option when it calls VirtualChannelInit to initialize the virtual channel. If this option is set, a CHANNEL_PDU_HEADER structure is placed at the beginning of each chunk of data read by a call to the WTSVirtualChannelRead function.

Requirements

Header pchannel.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

RDP Structures