Функция WTSOpenServerW (wtsapi32.h)

Статья
08/28/2023

Открывает дескриптор для указанного сервера узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).

Синтаксис

HANDLE WTSOpenServerW(
  [in] LPWSTR pServerName
);

Параметры

[in] pServerName

Указатель на строку, завершающуюся null, указывающую NetBIOS-имя сервера узла сеансов удаленных рабочих стола.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для указанного сервера.

Если функция завершается сбоем, она возвращает недопустимый дескриптор. Вы можете проверить допустимость дескриптора, используя его в другом вызове функции.

Не нужно открывать дескриптор для операций, выполняемых на сервере узла сеансов удаленных рабочих стола, на котором выполняется приложение. Вместо этого используйте константную WTS_CURRENT_SERVER_HANDLE .

Примечание

Заголовок wtsapi32.h определяет WTSOpenServer в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll

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

WTSCloseServer

Поделиться через