Функция DsListServersInSiteA (ntdsapi.h)
Функция DsListServersInSite выводит список всех серверов на сайте.
Синтаксис
NTDSAPI DWORD DsListServersInSiteA(
[in] HANDLE hDs,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppServers
);
Параметры
[in] hDs
Содержит дескриптор службы каталогов, полученный из функции DSBind или DSBindWithCred .
[in] site
Указатель на строку, завершающуюся нулевым значением, которая указывает имя сайта. Имя сайта использует формат различающегося имени. Он берется из списка сайтов, возвращаемого функцией DsListSites .
[out] ppServers
Указатель на указатель на структуру DS_NAME_RESULT , которая получает список серверов на сайте. Возвращаемую структуру необходимо освободить с помощью функции DsFreeNameResult .
Возвращаемое значение
Если функция возвращает список серверов, возвращаемое значение будет NO_ERROR. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.
Комментарии
Отдельные ошибки преобразования имен отображаются в возвращаемой DS_NAME_RESULT структуре.
Примечание
Заголовок ntdsapi.h определяет DsListServersInSite в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | ntdsapi.h |
| Библиотека | Ntdsapi.lib |
| DLL | Ntdsapi.dll |