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