IRDPSRAPIVirtualChannelManager ::CreateVirtualChannel, méthode (rdpencomapi.h)

Crée un canal virtuel.

Syntaxe

HRESULT CreateVirtualChannel(
  [in]  BSTR                    bstrChannelName,
  [in]  CHANNEL_PRIORITY        Priority,
  [in]  unsigned long           ChannelFlags,
  [out] IRDPSRAPIVirtualChannel **ppChannel
);

Paramètres

[in] bstrChannelName

Type : BSTR

Nom du canal. La longueur maximale est de 8 caractères, y compris le caractère de fin null. Les noms de canaux hérités sont limités à 32 caractères.

[in] Priority

Type : CHANNEL_PRIORITY

Priorité du canal. Ce paramètre peut prendre les valeurs suivantes.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Type : long non signé

Indicateurs qui déterminent la façon dont les données sont envoyées sur le canal. Ce paramètre peut être 0 ou CHANNEL_FLAGS_UNCOMPRESSED.

[out] ppChannel

Type : IRDPSRAPIVirtualChannel**

Pointeur d’interface IRDPSRAPIVirtualChannel .

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la valeur de retour est un code d’erreur. Voici une valeur possible.

Remarques

Lorsqu’un canal virtuel est créé, un canal virtuel RDP est lié à la couche de pile RDP pour chaque canal ouvert. Pour qu’un canal soit effectivement ouvert entre le client et le serveur, le client et le serveur doivent lier le canal. Le paramètre Priority est utilisé pour attribuer une priorité aux paquets envoyés sur le canal.

La liaison entre les canaux serveur et client est établie en fonction du nom du canal.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	rdpencomapi.h
DLL	RdpEncom.dll

Voir aussi

IRDPSRAPIVirtualChannelManager