Поделиться через


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

Возвращаемый код/значение Описание
STATUS_INVALID_DOMAIN_STATE
Операция является допустимой только на контроллерах домена в корневом домене.
STATUS_INVALID_DOMAIN_ROLE
Операция является допустимой только на основном контроллере домена.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
Библиотека Advapi32.lib
DLL Advapi32.dll