CSacl::AddAuditAce

添加跟踪访问控制项(ACE)到 CSacl 对象。

bool AddAuditAce(
   const CSid & rSid,
   ACCESS_MASK AccessMask,
   bool bSuccess,
   bool bFailure,
   BYTE AceFlags = 0
) throw(...);
bool AddAuditAce(
   const CSid & rSid,
   ACCESS_MASK AccessMask,
   bool bSuccess,
   bool bFailure,
   BYTE AceFlags,
   const GUID * pObjectType,
   const GUID * pInheritedObjectType 
) throw(...);

参数

  • rSid
    CSid 对象。

  • AccessMask
    指定访问权限会屏蔽指定的 CSid 对象审核。

  • bSuccess
    指定允许的访问尝试是否将审核。 将此标志设置为true启用审核;否则,将其设置为false。

  • bFailure
    指定访问被拒绝尝试是否将审核。 将此标志设置为true启用审核;否则,将其设置为false。

  • AceFlags
    设置位标志来控制ACE继承。

  • pObjectType
    对象类型。

  • pInheritedObjectType
    继承的对象类型。

返回值

返回 true,如果ACE添加到 CSacl 对象,在失败时进行 false

备注

CSacl 对象包含指定尝试访问的类型生成在安全事件日志的审核记录的访问控制项(ACEs)。 此方法添加这样的ACE到 CSacl 对象。 AddAuditAce 的第二个窗体仅在Windows 2000和更高版本中提供的。

为 AceFlags 参数可设置各种标志的说明参见 ACE_HEADER

要求

Header: atlsecurity.h

请参见

参考

CSacl选件类

CSid选件类

ACCESS_MASK

CSacl::RemoveAllAces