Функция 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 |