Функция DsListServersForDomainInSiteA (ntdsapi.h)

Статья
03/05/2024

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

Указатель на строку с пустым завершением, указывающую имя сайта. Эта строка берется из списка имен сайтов, возвращаемых функцией DsListSites .

[out] ppServers

Указатель на указатель на структуру DS_NAME_RESULT , которая получает список серверов в домене. Возвращаемую структуру необходимо освободить с помощью функции DsFreeNameResult .

Возвращаемое значение

Если функция возвращает список серверов, возвращается значение NO_ERROR. Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.

Заголовок ntdsapi.h определяет DsListServersForDomainInSite в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll

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

DS_NAME_RESULT

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

DsFreeNameResult

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