LsaQueryTrustedDomainInfo 函数 (ntsecapi.h)

项目
02/29/2024

LsaQueryTrustedDomainInfo 函数检索有关受信任域的信息。

语法

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

参数

[in] PolicyHandle

域控制器的 Policy 对象的句柄，该域控制器与 TrustedDomainSid 参数标识的域具有信任关系。句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。有关详细信息，请参阅打开策略对象句柄。

[in] TrustedDomainSid

指向要查询的受信任域的 SID 的指针。

[in] InformationClass

指定 TRUSTED_INFORMATION_CLASS 枚举类型中的下列值之一。值指示所请求的信息的类型。

值	含义
TrustedDomainNameInformation	检索受信任域的名称。 Buffer 参数接收指向 TRUSTED_DOMAIN_NAME_INFO 结构的指针。
TrustedPosixOffsetInformation	检索用于为受信任域生成 Posix 用户和组标识符的值。 Buffer 参数接收指向TRUSTED_POSIX_OFFSET_INFO结构的指针。
TrustedPasswordInformation	检索受信任域的密码。 Buffer 参数接收指向 TRUSTED_PASSWORD_INFO 结构的指针。在 PolicyHandle 参数中传递的句柄必须具有POLICY_GET_PRIVATE_INFORMATION访问权限。
TrustedDomainInformationEx	检索受信任域的扩展信息。 Buffer 参数接收指向TRUSTED_DOMAIN_INFORMATION_EX结构的指针。
TrustedDomainInformationBasic	不支持此值。
TrustedDomainFullInformation	检索受信任域的完整信息。此信息包括 Posix 偏移量信息、身份验证信息和为 TrustedDomainInformationEx 值返回的扩展信息。 Buffer 参数接收指向TRUSTED_DOMAIN_FULL_INFORMATION 结构的指针。

[out] Buffer

指向缓冲区的指针，该缓冲区接收指向包含所请求信息的结构的指针。结构的类型取决于 InformationClass 参数的值。

使用完信息后，通过将返回的指针传递给 LsaFreeMemory 来释放该指针。

返回值

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

如果函数失败，它将返回指示错误的 NTSTATUS 值。有关详细信息，请参阅 LSA 策略函数返回值。

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

要求

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