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