Функция DsEnumerateDomainTrustsA (dsgetdc.h)

Статья
08/23/2023

Функция DsEnumerateDomainTrusts получает данные о доверии домена для указанного домена.

Синтаксис

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *Domains,
  [out]          PULONG             DomainCount
);

Параметры

[in, optional] ServerName

Указатель на строку, завершающуюся значением NULL, которая указывает имя компьютера в домене для получения сведений о доверии. Если этот параметр имеет значение NULL, используется имя локального компьютера. Вызывающий объект должен быть пользователем, прошедшим проверку подлинности в этом домене.

Если этот компьютер является контроллером домена, эта функция немедленно возвращает данные доверия. Если этот компьютер не является контроллером домена, эта функция получает данные доверия из кэшированных данных, если срок действия кэшированных данных не истек. Если срок действия кэшированных данных истек, эта функция получает данные доверия от контроллера домена в домене, членом которого является этот компьютер, и обновляет кэш. Срок действия кэшированных данных автоматически истекает через пять минут.

[in] Flags

Содержит набор флагов, определяющий, какой домен доверяет перечислению. Это может быть ноль или сочетание одного или нескольких из следующих значений.

DS_DOMAIN_DIRECT_INBOUND

Перечисление доменов, которые напрямую доверяют домену, члену которого является ServerName .

DS_DOMAIN_DIRECT_OUTBOUND

Перечисление доменов, доверенных напрямую доменом, членом которого является ServerName .

DS_DOMAIN_IN_FOREST

Перечисление доменов, являющихся членами того же леса, в котором в качестве члена имеется имя_сервера .

DS_DOMAIN_NATIVE_MODE

Перечисление доменов, где основной домен работает в собственном режиме Windows 2000.

DS_DOMAIN_PRIMARY

Перечисление доменов, являющихся основным доменом домена, членом которого является Имя_сервера .

DS_DOMAIN_TREE_ROOT

Перечисление доменов, которые находятся в корне леса, членом которого является Имя_сервера .

[out] Domains

Указатель на значение PDS_DOMAIN_TRUSTS , которое получает массив DS_DOMAIN_TRUSTS структур. Каждая структура в этом массиве содержит данные о доверии для домена. Вызывающий объект должен освободить эту память, если она больше не требуется, вызвав NetApiBufferFree.

[out] DomainCount

Указатель на значение ULONG , которое получает количество элементов, возвращаемых в массиве Domains .

Возвращаемое значение

Возвращает ERROR_SUCCESS в случае успешного выполнения или код ошибки Win32 в противном случае. Возможные коды ошибок включают коды, перечисленные в следующем списке.

Заголовок dsgetdc.h определяет DsEnumerateDomainTrusts в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	dsgetdc.h
Библиотека	Netapi32.lib
DLL	Netapi32.dll

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

DS_DOMAIN_TRUSTS

Функции службы каталогов

NetApiBufferFree

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