Функция 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
Целевая платформа Windows
Header wtsapi32.h
Библиотека Wtsapi32.lib
DLL Wtsapi32.dll

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

WTSCloseServer