通过

LsaQueryForestTrustInformation 函数 （ntsecapi.h）

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

Syntax

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 Policy 函数返回值之一。

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

注解

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

要求

Requirement 价值
最低支持的客户端 无受支持的版本
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll
  • Last updated on