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