LsaQueryInformationPolicy 函数 (ntsecapi.h)

项目
03/05/2024

LsaQueryInformationPolicy 函数检索有关 Policy 对象的信息。

语法

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

参数

[in] PolicyHandle

Policy 对象的句柄。此句柄所需的访问权限取决于 InformationClass 参数的值。有关详细信息，请参阅打开策略对象句柄。

[in] InformationClass

指定 POLICY_INFORMATION_CLASS 枚举类型中的以下值之一。值指示要检索的信息的类型。

值	含义
PolicyAuditEventsInformation	检索系统的审核规则。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_AUDIT_INFORMATION访问权限。 Buffer 参数接收指向POLICY_AUDIT_EVENTS_INFO结构的指针。
PolicyPrimaryDomainInformation	检索系统主域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 Buffer 参数接收指向POLICY_PRIMARY_DOMAIN_INFO结构的指针。
PolicyAccountDomainInformation	检索系统帐户域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 Buffer 参数接收指向POLICY_ACCOUNT_DOMAIN_INFO结构的指针。
PolicyLsaServerRoleInformation	检索 LSA 服务器的角色。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 Buffer 参数接收指向POLICY_LSA_SERVER_ROLE_INFO结构的指针。
PolicyModificationInformation	检索有关 LSA 数据库的创建时间和上次修改的信息。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 Buffer 参数接收指向POLICY_MODIFICATION_INFO结构的指针。
PolicyDnsDomainInformation	检索域名系统 (DNS) 有关与 Policy 对象关联的主域的信息。 PolicyHandle 参数中传递的句柄必须具有POLICY_VIEW_LOCAL_INFORMATION访问权限。 Buffer 参数接收指向POLICY_DNS_DOMAIN_INFO结构的指针。

[out] Buffer

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

如果不再需要这些信息，请将返回的指针传递给 LsaFreeMemory。

返回值

如果 LsaQueryInformationPolicy 函数成功，则返回值为STATUS_SUCCESS。

如果函数失败，则返回值为 NTSTATUS 代码。有关详细信息，请参阅 LSA 策略函数返回值。

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

注解

有关演示如何调用此函数的示例，请参阅管理策略信息。

要求

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