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


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

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

Службы удаленных рабочих столов предоставляют указатель на функцию 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

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

VirtualChannelClose

VirtualChannelInit

VirtualChannelInitEvent

VirtualChannelOpenEvent

VirtualChannelWrite