AuditSetPerUserPolicy 函数 (ntsecapi.h)

  • 项目

AuditSetPerUserPolicy 函数在指定主体的一个或多个审核子类别中设置每用户审核策略。

语法

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

参数

[in] pSid

指向与要为其设置审核策略的主体关联的 SID 结构的指针。 目前不支持组 SID 的每用户策略。

[in] pAuditPolicy

指向AUDIT_POLICY_INFORMATION结构的数组 的 指针。 每个结构为一个审核子类别指定每用户审核策略。

忽略这些结构的 AuditCategoryGuid 成员。

[in] dwPolicyCount

pAuditPolicy 数组中的元素数。

返回值

如果函数成功，则返回 TRUE。

如果函数失败，则返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。 GetLastError 可能会返回 WinError.h 中定义的以下错误代码之一。

返回代码/值 说明
ERROR_ACCESS_DENIED
5
 调用方没有调用此函数所需的特权或访问权限。
ERROR_INVALID_PARAMETER
87
 一个或多个参数无效。
ERROR_NO_SUCH_USER
1317
 pSID 参数指定的 SID 结构与现有用户不关联。

注解

若要成功调用此函数，调用方必须具有 SeSecurityPrivilege 或对 Audit 安全对象具有AUDIT_SET_USER_POLICY访问权限。

要求

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

另请参阅

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy