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


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

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

Синтаксис

NTDSAPI DWORD DsListSitesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppSites
);

Параметры

[in] hDs

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

[out] ppSites

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

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

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

Комментарии

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

Примечание

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

Требования

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

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

DS_NAME_RESULT

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

DsFreeNameResult