Share via

LsaQueryTrustedDomainInfoByName 函数 (ntsecapi.h)

  • 项目

LsaQueryTrustedDomainInfoByName 函数返回有关受信任域的信息。

语法

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

参数

[in] PolicyHandle

Policy 对象的句柄。 此句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 有关详细信息，请参阅 打开策略对象句柄。

[in] TrustedDomainName

包含受信任域的名称的字符串。 这可以是域名或平面名称。

[in] InformationClass

指定要检索的信息的类型。 此参数的取值可为下列值之一：

值 含义
TrustedDomainNameInformation
 受信任域的名称。
TrustedPosixInformation
 受信任域的 Posix 偏移量。
TrustedPasswordInformation
 返回信任出站端的密码。
TrustedDomainInformationBasic
 不支持此值。
TrustedDomainInformationEx
 扩展信任信息，包括基本信息和 DNS 域名，以及有关信任的属性。
TrustedDomainFullInformation
 完整信息，包括 Posix 偏移量和身份验证信息。

[out] Buffer

接收指向返回的缓冲区的指针，该缓冲区包含请求的信息。 此缓冲区的格式和内容取决于信息类。 例如，如果将 InformationClass 设置为 TrustedDomainInformationEx， 则 Buffer 会收到指向 TRUSTED_DOMAIN_INFORMATION_EX 结构的指针。 有关详细信息，请参阅 TRUSTED_INFORMATION_CLASS。

使用完缓冲区后，通过调用 LsaFreeMemory 函数将其释放。

返回值

如果函数成功，该函数将返回STATUS_SUCCESS。

如果函数失败，它将返回 NTSTATUS 值，该值可以是下列值之一或 LSA 策略函数返回值之一。

值 说明
STATUS_ACCESS_DENIED
 调用方没有完成操作的适当访问权限。 有关所需访问类型的列表，请参阅 InformationClass 参数的说明。
STATUS_INSUFFICIENT_资源
 系统资源（如内存）不足，无法完成调用。
 

可以使用 LsaNtStatusToWinError 函数将 NTSTATUS 值转换为 Windows 错误代码。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS