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