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结构的指针，该结构包含要设置 ForestTrustInfo 参数所指定林信任信息的 TrustedDomain 对象的名称。

[in] ForestTrustInfo

指向 LSA_FOREST_TRUST_INFORMATION 结构的指针，该结构包含要设置为 TrustedDomainName 参数指定的 TrustedDomain 对象的林信任信息。

[in] CheckOnly

指定是否持久保存 对 TrustedDomain 对象的更改的布尔值。 如果此值为 TRUE，则此函数将检查与指定参数的冲突，但不会将 ForestTrustInfo 参数指定的林信任信息设置为 TrustedDomainName 参数指定的 TrustedDomain 对象。 如果此值为 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
标头	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll