188.8.131.52.5 LsarQueryTrustedDomainInfoByName (Opnum 48)
The LsarQueryTrustedDomainInfoByName method is invoked to retrieve information about a trusted domain object by its string name.
NTSTATUS LsarQueryTrustedDomainInfoByName( [in] LSAPR_HANDLE PolicyHandle, [in] PRPC_UNICODE_STRING TrustedDomainName, [in] TRUSTED_INFORMATION_CLASS InformationClass, [out, switch_is(InformationClass)] PLSAPR_TRUSTED_DOMAIN_INFO* TrustedDomainInformation );
TrustedDomainName: The name of the trusted domain object to query.
InformationClass: One of the TRUSTED_INFORMATION_CLASS values identifying the type of information the caller is interested in.
TrustedDomainInformation: Used to return the information requested by the caller.
Return Values: The following is a summary of the return values that an implementation MUST return, as specified by the message processing that follows.
The request was successfully completed.
The caller does not have the permissions to perform this operation.
One of the supplied parameters was invalid.
The trusted domain object with the specified name could not be found.
PolicyHandle is not a valid handle.
This message is identical in its operation to LsarQueryInfoTrustedDomain; the only exception is that the TrustedDomainName parameter is used to locate the trusted domain object, rather than having the caller supply the trusted domain object handle.
The trusted domain object is located by matching the TrustedDomainName parameter against the trusted domain object in the server's policy database. The trailing period on DNS names is ignored for the purposes of comparison.