共用方式為

LsaQueryForestTrustInformation 函式 (ntsecapi.h)

  • 發行項

LsaQueryForestTrustInformation 函式會擷取指定之 Local Security AuthorityTrustedDomain 物件的樹系信任資訊。

語法

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 物件不包含樹系信任資訊。

備註

此函式的存取受到安全性實體對象保護。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntsecapi.h
程式庫 Advapi32.lib
Dll Advapi32.dll