структура CHANNEL_PDU_HEADER (pchannel.h)

Статья
03/08/2023

Содержит сведения о блоке данных, полученном серверной частью виртуального канала.

Синтаксис

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

Члены

length

Размер блока данных в байтах, за исключением этого заголовка.

flags

Сведения о блоке данных. Будут установлены следующие битовые флаги. Обратите внимание, что не следует выполнять прямые сравнения с помощью оператора "==" при сравнении значений из следующего списка. Вместо этого используйте методы сравнения, описанные в списке.

CHANNEL_FLAG_FIRST (1)

Блок — это начало данных, записанных одной операцией записи.

При сравнении этого флага используйте побитовые сравнения.

CHANNEL_FLAG_LAST (2)

Фрагмент — это конец данных, записанных одной операцией записи.

При сравнении этого флага используйте побитовые сравнения.

CHANNEL_FLAG_MIDDLE (0)

Это значение по умолчанию. Блок находится в середине блока данных, записанного одной операцией записи.

Не используйте побитовые сравнения для непосредственного сравнения этого флага. Вместо этого используйте побитовые сравнения, чтобы определить, что значение флага не CHANNEL_FLAG_FIRST или не CHANNEL_FLAG_LAST. Для этого используется следующее сравнение:

Result = !(flags & CHANNEL_FLAG_FIRST) && !(flags & CHANNEL_FLAG_LAST)

CHANNEL_FLAG_ONLY (3)

Объединяет значения CHANNEL_FLAG_FIRST и CHANNEL_FLAG_LAST . Блок содержит все данные из одной операции записи.

При сравнении этого флага используйте побитовые сравнения.

В некоторых случаях службы удаленных рабочих столов помещает структуру CHANNEL_PDU_HEADER в начало каждого блока данных, считываемого вызовом функции WTSVirtualChannelRead . Это произойдет, если клиентская библиотека DLL задает параметр CHANNEL_OPTION_SHOW_PROTOCOL при вызове функции VirtualChannelInit для инициализации виртуального канала. Это также произойдет, если канал является динамическим виртуальным каналом, записанным с помощью метода IWTSVirtualChannel::Write .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	pchannel.h