Share via

AuditSetSecurity 函数 (ntsecapi.h)

  • 项目

AuditSetSecurity 函数设置一个安全描述符，用于委派对审核策略的访问权限。

语法

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

参数

[in] SecurityInformation

一个SECURITY_INFORMATION值，该值指定此函数设置的安全描述符的哪些部分。 仅支持 SACL_SECURITY_INFORMATION 和 DACL_SECURITY_INFORMATION 。 忽略任何其他值。 如果未指定 SACL_SECURITY_INFORMATION 或 DACL_SECURITY_INFORMATION ，则此函数将失败并返回 ERROR_INVALID_PARAMETER。

[in] pSecurityDescriptor

指向格式正确的 SECURITY_DESCRIPTOR 结构的指针，该结构控制对 Audit 安全对象的访问。 如果此参数为 NULL，则该函数将失败并返回 ERROR_INVALID_PARAMETER。

返回值

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

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

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

注解

若要成功调用此函数，调用方必须具有 SeSecurityPrivilege。

要求

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

另请参阅

AuditQuerySecurity