CHANNEL_PDU_HEADER 結構 (pchannel.h)

發行項
03/13/2024

包含虛擬通道伺服器端所接收之數據區塊的相關信息。

語法

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 在呼叫 VirtualChannelInit 函式來初始化虛擬通道時，會設定 CHANNEL_OPTION_SHOW_PROTOCOL 選項，就會發生這種情況。如果通道是使用 IWTSVirtualChannel：：Write 方法寫入的動態虛擬通道，也會發生這種情況。