Compartir a través de

Método IRDPSRAPIVirtualChannelManager::CreateVirtualChannel (rdpencomapi.h)

  • Artículo

Crea un canal virtual.

Sintaxis

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

Parámetros

[in] bstrChannelName

Tipo: BSTR

Nombre del canal. La longitud máxima es de 8 caracteres, incluido el carácter de terminación null. Los nombres de canal heredados están limitados a 32 caracteres.

[in] Priority

Tipo: CHANNEL_PRIORITY

Prioridad del canal. Este parámetro puede ser uno de los valores siguientes.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Tipo: long sin signo

Marcas que determinan cómo se envían los datos en el canal. Este parámetro puede ser 0 o CHANNEL_FLAGS_UNCOMPRESSED.

[out] ppChannel

Tipo: IRDPSRAPIVirtualChannel**

Puntero de interfaz IRDPSRAPIVirtualChannel .

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el valor devuelto es un código de error. A continuación se muestra un valor posible.

Comentarios

Cuando se crea un canal virtual, se enlaza un canal virtual RDP en la capa de pila de RDP para cada canal abierto. Para que un canal se abra realmente entre el cliente y el servidor, tanto el cliente como el servidor tienen que enlazar el canal. El parámetro Priority se usa para asignar una prioridad a los paquetes enviados en el canal.

El enlace entre los canales de servidor y cliente se establece en función del nombre del canal.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rdpencomapi.h
Archivo DLL RdpEncom.dll

Consulte también

IRDPSRAPIVirtualChannelManager