Функция WTSVirtualChannelOpen (wtsapi32.h)

Открывает дескриптор для серверного конца указанного виртуального канала.

Эта функция является устаревшей. Вместо этого используйте функцию WTSVirtualChannelOpenEx .

Синтаксис

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

Параметры

[in] hServer

Этот параметр должен быть WTS_CURRENT_SERVER_HANDLE.

[in] SessionId

Идентификатор сеанса Служб удаленных рабочих столов. Чтобы указать текущий сеанс, укажите WTS_CURRENT_SESSION. Функцию WTSEnumerateSessions можно использовать для получения идентификаторов всех сеансов на указанном сервере узла сеансов удаленных рабочих столов.

Чтобы открыть виртуальный канал в сеансе другого пользователя, необходимо иметь разрешение виртуального канала. Дополнительные сведения см. в разделе Разрешения служб удаленных рабочих столов. Чтобы изменить разрешения для сеанса, используйте средство администрирования Конфигурации служб удаленных рабочих столов.

[in] pVirtualName

Указатель на строку с пустым завершением, содержащую имя виртуального канала. Обратите внимание, что это строка ANSI, даже если определен ЮНИКОД. Имя виртуального канала состоит из одного CHANNEL_NAME_LEN символов, не включая завершающее значение NULL.

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

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

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

Комментарии

Завершив использование дескриптора, отпустите его, вызвав функцию WTSVirtualChannelClose .

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

Если вы попытаетесь использовать эту функцию, чтобы открыть один и тот же виртуальный канал несколько раз, это может привести к задержке в 10 секунд и нарушить работу установленного канала.

Требования

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

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose