CHANNEL_PDU_HEADER

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

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 will be 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 WTSVirtualChannelRead.

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.