struttura CHANNEL_PDU_HEADER (pchannel.h)

Articolo
03/01/2024

Contiene informazioni su un blocco di dati ricevuto dalla fine del server di un canale virtuale.

Sintassi

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

Members

length

Dimensione, in byte, del blocco di dati, esclusa questa intestazione.

flags

Informazioni sul blocco di dati. Verranno impostati i flag di bit seguenti. Si noti che non è consigliabile eseguire confronti diretti usando l'operatore '==' durante il confronto dei valori nell'elenco seguente; Usare invece i metodi di confronto descritti nell'elenco.

CHANNEL_FLAG_FIRST (1)

Il blocco è l'inizio dei dati scritti da una singola operazione di scrittura.

Usare confronti bit per bit durante il confronto di questo flag.

CHANNEL_FLAG_LAST (2)

Il blocco è la fine dei dati scritti da una singola operazione di scrittura.

Usare confronti bit per bit durante il confronto di questo flag.

CHANNEL_FLAG_MIDDLE (0)

Questo è il valore predefinito. Il blocco si trova al centro di un blocco di dati scritto da una singola operazione di scrittura.

Non usare confronti bit per bit per confrontare direttamente questo valore di flag. Usare invece confronti bit per bit per determinare che il valore del flag non è CHANNEL_FLAG_FIRST o CHANNEL_FLAG_LAST. A tale scopo, usare il confronto seguente:

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

CHANNEL_FLAG_ONLY (3)

Combina i valori CHANNEL_FLAG_FIRST e CHANNEL_FLAG_LAST . Il blocco contiene tutti i dati di una singola operazione di scrittura.

Usare confronti bit per bit durante il confronto di questo flag.

Commenti

In alcuni casi, Servizi Desktop remoto inserisce una struttura CHANNEL_PDU_HEADER all'inizio di ogni blocco di dati letto da una chiamata alla funzione WTSVirtualChannelRead . Ciò si verifica se la DLL client imposta l'opzione CHANNEL_OPTION_SHOW_PROTOCOL quando chiama la funzione VirtualChannelInit per inizializzare il canale virtuale. Ciò si verifica anche se il canale è un canale virtuale dinamico scritto in usando il metodo IWTSVirtualChannel::Write .