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

Статья
11/20/2024

Функция 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) для контроллера домена (DC).

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

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

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

Замечания

Ошибки преобразования отдельных имен сообщаются в возвращаемой DS_NAME_RESULT структуре.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll