Функция WTSOpenServerExA (wtsapi32.h)
Открывает дескриптор для указанного сервера узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов) или сервера узла виртуализации удаленных рабочих столов (узел виртуализации удаленных рабочих столов).
Синтаксис
HANDLE WTSOpenServerExA(
[in] LPSTR pServerName
);
Параметры
[in] pServerName
Указатель на строку, завершающуюся null, которая содержит NetBIOS-имя сервера.
Возвращаемое значение
Если функция выполняется успешно, возвращается дескриптор указанного сервера.
Если функция завершается сбоем, она возвращает недопустимый дескриптор. Вы можете проверить допустимость дескриптора, используя его в другом вызове функции.
Комментарии
Если сервер, указанный параметром pServerName , является сервером узла сеансов удаленных рабочих столов, поведение этой функции идентично поведению функции WTSOpenServer .
Для работы с сеансами, выполняемыми на виртуальных машинах на сервере узла виртуализации удаленных рабочих столов, на котором выполняется вызывающее приложение, укажите WTS_CURRENT_SERVER_NAME в параметре pServerName .
Завершив использование дескриптора, возвращенного этой функцией, отпустите его, вызвав функцию WTSCloseServer .
Примечание
Заголовок wtsapi32.h определяет WTSOpenServerEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 |
| Минимальная версия сервера | Windows Server 2008 R2 |
| Целевая платформа | Windows |
| Header | wtsapi32.h |
| Библиотека | Wtsapi32.lib |
| DLL | Wtsapi32.dll |