Функция обратного вызова 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 |