LsaQueryForestTrustInformation function
The LsaQueryForestTrustInformation function retrieves forest trust information for the specified Local Security Authority TrustedDomain object.
Syntax
NTSTATUS NTAPI LsaQueryForestTrustInformation( _In_ LSA_HANDLE PolicyHandle, _In_ PLSA_UNICODE_STRING TrustedDomainName, _Out_ PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo );
Parameters
- PolicyHandle [in]
-
A handle to the Policy object for the system.
- TrustedDomainName [in]
-
Pointer to an LSA_UNICODE_STRING structure that contains the name of the TrustedDomain object for which to retrieve forest trust information.
- ForestTrustInfo [out]
-
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. |
Remarks
Access to this function is protected by a securable object.
Requirements
|
Minimum supported client |
None supported |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|