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 原則函式傳回值。

傳回碼/值	Description
STATUS_INVALID_DOMAIN_ROLE	此作業僅在主要網域控制站上合法。
STATUS_INVALID_DOMAIN_STATE	此作業僅在根網域中的網域控制站上合法。
STATUS_NO_SUCH_DOMAIN	指定的 TrustedDomain 物件不存在。
STATUS_NOT_FOUND	指定的 TrustedDomain 物件不包含樹系信任資訊。

備註

此函式的存取權受到安全性實體物件的保護。

需求

Requirement	價值觀
最低支援的用戶端	不支援
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
Header	ntsecapi.h
Library	Advapi32.lib
DLL	Advapi32.dll