nf-ntsecapi-lsaquerytrusteddomaininfobyname.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:ntsecapi.LsaQueryTrustedDomainInfoByName	LsaQueryTrustedDomainInfoByName function (ntsecapi.h)	The LsaQueryTrustedDomainInfoByName function returns information about a trusted domain.	LsaQueryTrustedDomainInfoByName LsaQueryTrustedDomainInfoByName function [Security] TrustedDomainFullInformation TrustedDomainInformationBasic TrustedDomainInformationEx TrustedDomainNameInformation TrustedPasswordInformation TrustedPosixInformation _lsa_lsaquerytrusteddomaininfobyname ntsecapi/LsaQueryTrustedDomainInfoByName security.lsaquerytrusteddomaininfobyname	security\lsaquerytrusteddomaininfobyname.htm	security	d33d6cee-bd8b-49f4-8e65-07cdc65bec7c	12/05/2018	LsaQueryTrustedDomainInfoByName, LsaQueryTrustedDomainInfoByName function [Security], TrustedDomainFullInformation, TrustedDomainInformationBasic, TrustedDomainInformationEx, TrustedDomainNameInformation, TrustedPasswordInformation, TrustedPosixInformation, _lsa_lsaquerytrusteddomaininfobyname, ntsecapi/LsaQueryTrustedDomainInfoByName, security.lsaquerytrusteddomaininfobyname	ntsecapi.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Advapi32.lib	Advapi32.dll		Windows			19H1	LsaQueryTrustedDomainInfoByName ntsecapi/LsaQueryTrustedDomainInfoByName	c++	APIRef kbSyntax	DllExport	Advapi32.dll	LsaQueryTrustedDomainInfoByName

LsaQueryTrustedDomainInfoByName function

-description

The LsaQueryTrustedDomainInfoByName function returns information about a trusted domain.

-parameters

-param PolicyHandle [in]

A handle to a Policy object. This handle must have the POLICY_VIEW_LOCAL_INFORMATION access right. For more information, see Opening a Policy Object Handle.

-param TrustedDomainName [in]

String that contains the name of the trusted domain. This can either be the domain name or the flat name.

-param InformationClass [in]

Specifies the type of information to retrieve. This parameter can be one of the following values.

Value	Meaning
TrustedDomainNameInformation	Name of the trusted domain.
TrustedPosixInformation	Posix offset of the trusted domain.
TrustedPasswordInformation	Returns the password on the outbound side of the trust.
TrustedDomainInformationBasic	This value is not supported.
TrustedDomainInformationEx	Extended trust information, including the basic information and DNS domain name, and attributes about the trust.
TrustedDomainFullInformation	Full information, including the Posix offset and the authentication information.

-param Buffer [out]

Receives a pointer to the returned buffer that contains the requested information. The format and content of this buffer depend on the information class. For example, if InformationClass is set to TrustedDomainInformationEx, Buffer receives a pointer to a TRUSTED_DOMAIN_INFORMATION_EX structure. For more information, see TRUSTED_INFORMATION_CLASS.

When you have finished using the buffer, free it by calling the LsaFreeMemory function.

-returns

If the function succeeds, the function returns STATUS_SUCCESS.

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

Value	Description
STATUS_ACCESS_DENIED	Caller does not have the appropriate access to complete the operation. For a list of the required access types, see the description of the InformationClass parameter.
STATUS_INSUFFICIENT_ RESOURCES	Insufficient system resources, such as memory, to complete the call.

 

You can use the LsaNtStatusToWinError function to convert the NTSTATUS value to a Windows error code.

-see-also

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS