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