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

Статья
08/25/2023

Функция DsListInfoForServer выводит список прочих данных для сервера.

Синтаксис

NTDSAPI DWORD DsListInfoForServerA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           server,
  [out] PDS_NAME_RESULTA *ppInfo
);

Параметры

[in] hDs

Содержит дескриптор службы каталогов, полученный от функции DSBind или DSBindWithCred .

[in] server

Указатель на строку, завершающуюся значением NULL, которая указывает имя сервера. Это имя должно совпадать с одной из строк, возвращаемых функцией DsListServersForDomainInSite или DsListServersInSite .

[out] ppInfo

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

Индексы массива в структуре DS_NAME_RESULT указывают, какие данные содержатся в каждом элементе массива. Следующие константы можно использовать для указания требуемого индекса для определенного фрагмента данных.

DS_LIST_ACCOUNT_OBJECT_FOR_SERVER

Имя объекта учетной записи для контроллера домена (DC).

DS_LIST_DNS_HOST_NAME_FOR_SERVER

Dns-имя узла контроллера домена.

DS_LIST_DSA_OBJECT_FOR_SERVER

GUID агента службы каталогов (DSA) для контроллера домена .

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

Если функция возвращает данные сервера, возвращается значение NO_ERROR.

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

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

Требования

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

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

DS_NAME_RESULT

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

DsFreeNameResult

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