Функция 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 секунд и нарушить работу установленного канала.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wtsapi32.h |
| Библиотека | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Набор API | ext-ms-win-session-wtsapi32-l1-1-0 (представлено в Windows 8) |