Функция обратного вызова VIRTUALCHANNELOPEN (cchannel.h)

Статья
08/22/2023

Открывает клиентский конец виртуального канала.

Службы удаленных рабочих столов предоставляют указатель на функцию VirtualChannelOpen в структуре CHANNEL_ENTRY_POINTS , переданной точке входа VirtualChannelEntry .

Синтаксис

VIRTUALCHANNELOPEN Virtualchannelopen;

UINT VCAPITYPE Virtualchannelopen(
  [in]  LPVOID pInitHandle,
  [out] LPDWORD pOpenHandle,
  [in]  PCHAR pChannelName,
  [in]  PCHANNEL_OPEN_EVENT_FN pChannelOpenEventProc
)
{...}

Параметры

[in] pInitHandle

Дескриптор клиентского подключения. Это дескриптор, возвращаемый в параметре ppInitHandle функции VirtualChannelInit .

[out] pOpenHandle

Указатель на переменную, которая получает дескриптор, идентифицирующий открытый виртуальный канал в последующих вызовах функций VirtualChannelWrite и VirtualChannelClose .

[in] pChannelName

Указатель на строку символов ANSI, завершающуюся null, которая содержит имя открываемого виртуального канала. Имя должно быть зарегистрировано при вызове клиентом функции VirtualChannelInit .

[in] pChannelOpenEventProc

Указатель на определяемую приложением функцию VirtualChannelOpenEvent , которую службы удаленных рабочих столов вызывают для уведомления клиентской библиотеки DLL о событиях для этого виртуального канала.

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

Если функция выполняется успешно, возвращаемое значение будет CHANNEL_RC_OK.

При возникновении ошибки функция возвращает одно из следующих значений.

Библиотека DLL клиента не может вызвать эту функцию, пока клиент не установит соединение с сервером узла сеансов удаленных рабочих стола. Функция VirtualChannelInitEvent получает CHANNEL_EVENT_CONNECTED уведомление при установке подключения к серверу узла сеансов удаленных рабочих стола.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	cchannel.h