Функция LsaSetForestTrustInformation (ntsecapi.h)
Функция LsaSetForestTrustInformation задает сведения о доверии леса для указанного объекта TrustedDomainлокального центра безопасности.
Синтаксис
NTSTATUS LsaSetForestTrustInformation(
[in] LSA_HANDLE PolicyHandle,
[in] PLSA_UNICODE_STRING TrustedDomainName,
[in] PLSA_FOREST_TRUST_INFORMATION ForestTrustInfo,
[in] BOOLEAN CheckOnly,
[out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);
Параметры
[in] PolicyHandle
Дескриптор объекта Policy для системы.
[in] TrustedDomainName
Указатель на структуру LSA_UNICODE_STRING , содержащую имя объекта TrustedDomain , для которого необходимо задать сведения о доверии леса, заданные параметром ForestTrustInfo .
[in] ForestTrustInfo
Указатель на структуру LSA_FOREST_TRUST_INFORMATION , содержащую сведения о доверии леса, которые необходимо задать для объекта TrustedDomain , заданного параметром TrustedDomainName .
[in] CheckOnly
Логическое значение, указывающее, сохраняются ли изменения в объекте TrustedDomain . Если это значение равно TRUE, эта функция будет проверка для конфликтов с указанными параметрами, но не будет задавать сведения о доверии леса, указанные параметром ForestTrustInfo, для объекта TrustedDomain, заданного параметром TrustedDomainName. Если это значение равно FALSE, в качестве сведений о доверии леса будет задан объект TrustedDomain .
[out] CollisionInfo
Указатель на указатель на структуру LSA_FOREST_TRUST_COLLISION_INFORMATION , которая возвращает сведения о любых возникших конфликтах.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой код NTSTATUS, который может быть одним из следующих значений или одним из возвращаемых значений функции политики LSA.
Возвращаемый код/значение | Описание |
---|---|
|
Операция является допустимой только на контроллерах домена в корневом домене. |
|
Операция является допустимой только на основном контроллере домена. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Ни одна версия не поддерживается |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | ntsecapi.h |
Библиотека | Advapi32.lib |
DLL | Advapi32.dll |