Share via


CSecurityDesc::GetDacl

 

Retrieves discretionary access-control list (DACL) information from the security descriptor.

Syntax

      bool GetDacl(
   CDacl * pDacl,
   bool * pbPresent = NULL,
   bool * pbDefaulted = NULL 
) const throw(...);

Parameters

  • pDacl
    Pointer to an CDacl structure in which to store a copy of the security descriptor's DACL. If a discretionary ACL exists, the method sets pDacl to the address of the security descriptor's discretionary ACL. If a discretionary ACL does not exist, no value is stored.

  • pbPresent
    Pointer to a value that indicates the presence of a discretionary ACL in the specified security descriptor. If the security descriptor contains a discretionary ACL, this parameter is set to true. If the security descriptor does not contain a discretionary ACL, this parameter is set to false.

  • pbDefaulted
    Pointer to a flag set to the value of the SE_DACL_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure if a discretionary ACL exists for the security descriptor. If this flag is true, the discretionary ACL was retrieved by a default mechanism; if false, the discretionary ACL was explicitly specified by a user.

Return Value

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

Requirements

Header: atlsecurity.h

See Also

CSecurityDesc Class
GetSecurityDescriptorDacl
CSecurityDesc::GetControl
CSecurityDesc::GetGroup
CSecurityDesc::GetOwner
CSecurityDesc::GetSacl
CSecurityDesc::SetDacl