LsaQueryForestTrustInformation function (ntsecapi.h)

The LsaQueryForestTrustInformation function retrieves forest trust information for the specified Local Security Authority TrustedDomain object.


NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,


[in] PolicyHandle

A handle to the Policy object for the system.

[in] TrustedDomainName

Pointer to an LSA_UNICODE_STRING structure that contains the name of the TrustedDomain object for which to retrieve forest trust information.

[out] ForestTrustInfo

Pointer to an LSA_FOREST_TRUST_INFORMATION structure that returns the forest trust information for the TrustedDomain object specified by the TrustedDomainName parameter.

Return value

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code, which can be one of the following values or one of the LSA Policy Function Return Values.

Return code/value Description
The operation is legal only on the primary domain controller.
The operation is legal only on domain controllers in the root domain.
The specified TrustedDomain object does not exist.
The specified TrustedDomain object does not contain forest trust information.


Access to this function is protected by a securable object.


Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll