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 枚举类型中的以下值之一。 值指示要设置的信息类型。
| 值 | 含义 |
|---|---|
|
设置系统的审核规则。 PolicyHandle 参数中传递的句柄必须具有POLICY_SET_AUDIT_REQUIREMENTS访问权限。 Buffer 参数必须是指向POLICY_AUDIT_EVENTS_INFO结构的指针。 |
|
设置系统主域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_PRIMARY_DOMAIN_INFO结构的指针。 |
|
设置系统帐户域的名称和 SID。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_ACCOUNT_DOMAIN_INFO结构的指针。 |
|
设置域名系统 (DNS) 有关与 Policy 对象关联的主域的信息。 PolicyHandle 参数中传递的句柄必须具有POLICY_TRUST_ADMIN访问权限。 Buffer 参数必须是指向POLICY_DNS_DOMAIN_INFO结构的指针。 |
|
设置 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 |