LsaQueryForestTrustInformation 函数 (ntsecapi.h)

  • 项目

LsaQueryForestTrustInformation 函数检索指定本地安全机构TrustedDomain 对象的林信任信息。

语法

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

参数

[in] PolicyHandle

系统的 Policy 对象的句柄。

[in] TrustedDomainName

指向 LSA_UNICODE_STRING 结构的指针，该结构包含要检索其林信任信息的 TrustedDomain 对象的名称。

[out] ForestTrustInfo

指向 LSA_FOREST_TRUST_INFORMATION 结构的指针，该结构返回 TrustedDomainName 参数指定的 TrustedDomain 对象的林信任信息。

返回值

如果函数成功，则返回值STATUS_SUCCESS。

如果函数失败，则返回值为 NTSTATUS 代码，可以是以下值之一或 LSA 策略函数返回值之一。

返回代码/值 说明
STATUS_INVALID_DOMAIN_ROLE
 该操作仅在主域控制器上合法。
STATUS_INVALID_DOMAIN_STATE
 该操作仅在根域中的域控制器上合法。
STATUS_NO_SUCH_DOMAIN
 指定的 TrustedDomain 对象不存在。
STATUS_NOT_FOUND
 指定的 TrustedDomain 对象不包含林信任信息。

注解

对此函数的访问受安全对象保护。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll