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


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

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

Синтаксис

BOOL WTSEnumerateServersA(
  [in] LPSTR             pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOA *ppServerInfo,
       DWORD             *pCount
);

Параметры

[in] pDomainName

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

[in] Reserved

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

[in] Version

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

ppServerInfo

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

pCount

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

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

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

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

Комментарии

Эта функция не будет работать, если NetBT отключен.

Примечание

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

Требования

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

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

WTS_SERVER_INFO