Функция DsListRolesA (ntdsapi.h)
Функция DsListRoles выводит список ролей, распознаваемых сервером.
Синтаксис
NTDSAPI DWORD DsListRolesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppRoles
);
Параметры
[in] hDs
Содержит дескриптор службы каталогов, полученный от функции DSBind или DSBindWithCred .
[out] ppRoles
Указатель на переменную, которая получает указатель на структуру DS_NAME_RESULT , содержащую роли, распознаемые сервером. Возвращаемая структура должна быть освобождена с помощью DsFreeNameResult.
Индексы массива в структуре DS_NAME_RESULT указывают, какие данные содержатся в каждом элементе массива. Следующие константы можно использовать для указания требуемого индекса для определенного фрагмента данных.
DS_ROLE_DOMAIN_OWNER
Сервер владеет доменом.
DS_ROLE_INFRASTRUCTURE_OWNER
Сервер владеет инфраструктурой.
DS_ROLE_PDC_OWNER
Сервер владеет PDC.
DS_ROLE_RID_OWNER
Сервер владеет RID.
DS_ROLE_SCHEMA_OWNER
Сервер владеет схемой.
Возвращаемое значение
Если функция возвращает список ролей, возвращаемое значение будет NO_ERROR.
Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.
Отдельные ошибки преобразования имен отображаются в возвращаемой структуре DS_NAME_RESULT .
Комментарии
Примечание
Заголовок ntdsapi.h определяет DsListRoles в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | ntdsapi.h |
| Библиотека | Ntdsapi.lib |
| DLL | Ntdsapi.dll |