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

Функция 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
Целевая платформа Windows
Header dsgetdc.h
Библиотека Netapi32.lib
DLL Netapi32.dll

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

DS_DOMAIN_TRUSTS

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

NetApiBufferFree