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