Функция 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 |
| целевая платформа | Виндоус |
| заголовка | wtsapi32.h |
| библиотеки |
Wtsapi32.lib |
| DLL | Wtsapi32.dll |