Метод IRDPSRAPIVirtualChannelManager::CreateVirtualChannel (rdpencomapi.h)

Статья
03/05/2024

Создает виртуальный канал.

Синтаксис

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

Параметры

[in] bstrChannelName

Тип: BSTR

Имя канала. Максимальная длина составляет 8 символов, включая символ конца null. Устаревшие имена каналов ограничены 32 символами.

[in] Priority

Тип: CHANNEL_PRIORITY

Приоритет канала. Этот параметр может принимать одно из указанных ниже значений.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Тип: unsigned long

Флаги, определяющие способ отправки данных в канале. Этот параметр может быть 0 или CHANNEL_FLAGS_UNCOMPRESSED.

[out] ppChannel

Тип: IRDPSRAPIVirtualChannel**

Указатель интерфейса IRDPSRAPIVirtualChannel .

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращаемое значение является кодом ошибки. Ниже приведено возможное значение.

При создании виртуального канала виртуальный канал RDP привязывается к уровню стека RDP для каждого открытого канала. Чтобы канал фактически был открыт между клиентом и сервером, необходимо связать его как клиентом, так и сервером. Параметр Priority используется для назначения приоритета пакетам, отправляемых по каналу.

Привязка между каналами сервера и клиента устанавливается на основе имени канала.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	rdpencomapi.h
DLL	RdpEncom.dll

См. также раздел

IRDPSRAPIVirtualChannelManager

Поделиться через