Функция DsGetForestTrustInformationW (dsgetdc.h)
Функция DsGetForestTrustInformationW получает данные доверия леса для указанного домена.
Синтаксис
DSGETDCAPI DWORD DsGetForestTrustInformationW(
[in, optional] LPCWSTR ServerName,
[in, optional] LPCWSTR TrustedDomainName,
[in] DWORD Flags,
[out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);
Параметры
[in, optional] ServerName
Содержит имя контроллера домена, к которому удаленно подключен DsGetForestTrustInformationW . Вызывающий объект должен быть пользователем, прошедшим проверку подлинности на этом сервере. Если этот параметр имеет значение NULL, используется локальный сервер.
[in, optional] TrustedDomainName
Содержит NETBIOS-имя или DNS-имя доверенного домена, для которого требуется извлечь данные доверия леса. Этот домен должен иметь атрибут доверия TRUST_ATTRIBUTE_FOREST_TRANSITIVE . Дополнительные сведения см. в разделе TRUSTED_DOMAIN_INFORMATION_EX.
Если этот параметр имеет значение NULL, извлекаются данные доверия леса для домена, размещенного по параметру ServerName .
[in] Flags
Содержит набор флагов, которые изменяют поведение этой функции. Это может быть ноль или следующее значение.
DS_GFTI_UPDATE_TDO
Если этот флаг установлен, DsGetForestTrustInformationW обновит данные доверия леса доверенного домена, определяемого параметром TrustedDomainName . В этом случае параметр TrustedDomainName не может иметь значение NULL. Вызывающий объект должен иметь доступ для изменения данных доверия, иначе возвращается ERROR_ACCESS_DENIED .
Этот флаг действителен, только если ServerName указывает основной контроллер домена.
[out] ForestTrustInfo
Указатель на указатель LSA_FOREST_TRUST_INFORMATION структуры, который получает данные о доверии леса, описывающие пространства имен, указанные доменом, заданным параметром TrustedDomainName. Элемент Time для всех возвращенных записей будет равен нулю.
Вызывающий объект должен освободить эту структуру, если она больше не требуется, вызвав NetApiBufferFree.
Возвращаемое значение
Возвращает NO_ERROR в случае успешного выполнения или код ошибки Win32 в противном случае. Возможные коды ошибок включают следующие.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | dsgetdc.h |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |