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

Статья
02/29/2024

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

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

DS_NAME_RESULT

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

DsFreeNameResult

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