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