Поделиться через


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

См. также раздел

DS_NAME_RESULT

Контроллер домена и функции управления репликацией

DsFreeNameResult