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

Статья
08/28/2023

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

Синтаксис

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

Параметры

[in] pServerName

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

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

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

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

Для работы с сеансами, выполняемыми на виртуальных машинах на сервере узла виртуализации удаленных рабочих столов, на котором выполняется вызывающее приложение, укажите 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

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

WTSCloseServer

WTSOpenServer

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