Функция 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
Перечисление доменов, которые напрямую доверяют домену, члену которого является 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 |
См. также раздел
Обратная связь
Отправить и просмотреть отзыв по