LsaSetInformationPolicy 函数 (ntsecapi.h)

  • 项目

LsaSetInformationPolicy 函数修改 Policy 对象中的信息。

语法

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

参数

[in] PolicyHandle

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

[in] InformationClass

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

值 含义
PolicyAuditEventsInformation
 设置系统的审核规则。 PolicyHandle 参数中传递的句柄必须具有POLICY_SET_AUDIT_REQUIREMENTS访问权限。 Buffer 参数必须是指向POLICY_AUDIT_EVENTS_INFO结构的指针。
PolicyPrimaryDomainInformation
 设置系统主域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_PRIMARY_DOMAIN_INFO结构的指针。
PolicyAccountDomainInformation
 设置系统帐户域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_ACCOUNT_DOMAIN_INFO结构的指针。
PolicyDnsDomainInformation
 设置域名系统 (DNS) 有关与 Policy 对象关联的主域的信息。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_DNS_DOMAIN_INFO结构的指针。
PolicyLsaServerRoleInformation
 设置 LSA 服务器的角色。 PolicyHandle 参数中传递的句柄必须具有POLICY_SERVER_ADMIN访问权限。 Buffer 参数必须是指向POLICY_LSA_SERVER_ROLE_INFO结构的指针。

将服务器的角色从主服务器更改为备份 (不起作用，尽管函数返回STATUS_SUCCESS) 。 将服务器的角色从备份更改为主服务器需要大量的网络操作，并且速度可能很慢。

[in] Buffer

指向包含要设置的信息的结构的指针。 结构的类型取决于 InformationClass 参数的值。

返回值

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

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

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

要求

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

另请参阅

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO