Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | ntdsapi.h |
| библиотеки |
Ntdsapi.lib |
| DLL | Ntdsapi.dll |