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

Статья
08/28/2023

Возвращает список всех серверов узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов) в указанном домене.

Синтаксис

BOOL WTSEnumerateServersW(
  [in] LPWSTR            pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOW *ppServerInfo,
       DWORD             *pCount
);

Параметры

[in] pDomainName

Указатель на имя домена для запроса. Если значение этого параметра равно NULL, указанный домен является текущим доменом.

[in] Reserved

Зарезервировано. Значение этого параметра должно быть равно 0.

[in] Version

Версия запроса перечисления. Значение параметра должно быть равно 1.

ppServerInfo

Указывает на массив WTS_SERVER_INFO структур, который содержит возвращаемые результаты перечисления. После использования память, используемая этим буфером, должна быть освобождена путем вызова WTSFreeMemory.

pCount

Указатель на переменную, которая получает количество WTS_SERVER_INFO структур, возвращаемых в буфер ppServerInfo .

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

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

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

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

Требования

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

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

WTS_SERVER_INFO

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