AuditEnumeratePerUserPolicy 函数 (ntsecapi.h)

AuditEnumeratePerUserPolicy 函数枚举为其指定了每用户审核策略的用户。

语法

BOOLEAN AuditEnumeratePerUserPolicy(
  [out] PPOLICY_AUDIT_SID_ARRAY *ppAuditSidArray
);

参数

[out] ppAuditSidArray

指向单个缓冲区的指针,该缓冲区包含指向 POLICY_AUDIT_SID_ARRAY 结构和结构本身的指针数组。 POLICY_AUDIT_SID_ARRAY结构指定为其指定了按用户审核策略的用户。

使用此缓冲区后,请通过调用 AuditFree 函数来释放该缓冲区。

返回值

如果该函数成功,则返回 TRUE

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

返回代码/值 说明
ERROR_ACCESS_DENIED
5
调用方没有调用此函数所需的特权或访问权限。
ERROR_INVALID_PARAMETER
87
一个或多个参数无效。

注解

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

要求

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