CSecurityDesc::GetSacl

Retrieves system access-control list (SACL) information from the security descriptor.

bool GetSacl(
   CSacl * pSacl,
   bool * pbPresent = NULL,
   bool * pbDefaulted = NULL 
) const throw(...);

Parameters

  • pSacl
    Pointer to an CSacl structure in which to store a copy of the security descriptor's SACL. If a system ACL exists, the method sets pSacl to the address of the security descriptor's system ACL. If a system ACL does not exist, no value is stored.

  • pbPresent
    Pointer to a flag the method sets to indicate the presence of a system ACL in the specified security descriptor. If the security descriptor contains a system ACL, this parameter is set to true. If the security descriptor does not contain a system ACL, this parameter is set to false.

  • pbDefaulted
    Pointer to a flag set to the value of the SE_SACL_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure if a system ACL exists for the security descriptor.

Return Value

Returns true if the method succeeds, false if it fails.

Requirements

Header: atlsecurity.h

See Also

Concepts

CSecurityDesc Class

CSecurityDesc Members

GetSecurityDescriptorSacl

CSecurityDesc::GetControl

CSecurityDesc::GetDacl

CSecurityDesc::GetGroup

CSecurityDesc::GetOwner

CSecurityDesc::SetSacl