structure CHANNEL_PDU_HEADER (pchannel.h)

Article
03/06/2024

Contient des informations sur un bloc de données reçu par l’extrémité du serveur d’un canal virtuel.

Syntaxe

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

Membres

length

Taille, en octets, du bloc de données, à l’exclusion de cet en-tête.

flags

Informations sur le bloc de données. Les indicateurs de bits suivants seront définis. Notez que vous ne devez pas effectuer de comparaisons directes à l’aide de l’opérateur « == » lors de la comparaison des valeurs de la liste suivante ; utilisez plutôt les méthodes de comparaison décrites dans la liste.

CHANNEL_FLAG_FIRST (1)

Le segment est le début des données écrites par une seule opération d’écriture.

Utilisez des comparaisons au niveau du bit lors de la comparaison de cet indicateur.

CHANNEL_FLAG_LAST (2)

Le segment est la fin des données écrites par une seule opération d’écriture.

Utilisez des comparaisons au niveau du bit lors de la comparaison de cet indicateur.

CHANNEL_FLAG_MIDDLE (0)

Il s’agit de la valeur par défaut. Le segment se trouve au milieu d’un bloc de données écrit par une seule opération d’écriture.

N’utilisez pas de comparaisons au niveau du bit pour comparer directement cette valeur d’indicateur. Utilisez plutôt des comparaisons au niveau du bit pour déterminer que la valeur de l’indicateur n’est pas CHANNEL_FLAG_FIRST ou CHANNEL_FLAG_LAST. Pour ce faire, utilisez la comparaison suivante :

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

CHANNEL_FLAG_ONLY (3)

Combine les valeurs CHANNEL_FLAG_FIRST et CHANNEL_FLAG_LAST . Le segment contient toutes les données d’une seule opération d’écriture.

Utilisez des comparaisons au niveau du bit lors de la comparaison de cet indicateur.

Remarques

Dans certains cas, les services Bureau à distance placent une structure CHANNEL_PDU_HEADER au début de chaque bloc de données lu par un appel à la fonction WTSVirtualChannelRead . Cela se produit si la DLL cliente définit l’option CHANNEL_OPTION_SHOW_PROTOCOL lorsqu’elle appelle la fonction VirtualChannelInit pour initialiser le canal virtuel. Cela se produit également si le canal est un canal virtuel dynamique écrit dans à l’aide de la méthode IWTSVirtualChannel ::Write .