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

Статья
11/20/2024

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

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

DS_DOMAIN_DIRECT_OUTBOUND

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

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, которое получает количество элементов, возвращаемых в массиве доменов .

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	dsgetdc.h
библиотеки	Netapi32.lib
DLL	Netapi32.dll

См. также

DS_DOMAIN_TRUSTS

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

NetApiBufferFree

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