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


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

Возврат кода или значения Description
STATUS_INVALID_DOMAIN_STATE
Операция является законной только для контроллеров домена в корневом домене.
STATUS_INVALID_DOMAIN_ROLE
Операция является законной только для основного контроллера домена.

Требования

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