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 |