GetSecurityDescriptorSacl

The GetSecurityDescriptorSacl function retrieves a pointer to the SACL in a specified security descriptor.

BOOL GetSecurityDescriptorSacl(
  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  LPBOOL lpbSaclPresent,
  PACL* pSacl,
  LPBOOL lpbSaclDefaulted
);

Parameters

pSecurityDescriptor

[in] Pointer to the SECURITY_DESCRIPTOR structure containing the SACL to which the function retrieves a pointer.

lpbSaclPresent

[out] Pointer to a flag the function sets to indicate the presence of a SACL in the specified security descriptor. If this parameter is TRUE, the security descriptor contains a SACL, and the remaining output parameters in this function receive valid values. If this parameter is FALSE, the security descriptor does not contain a SACL, and the remaining output parameters do not receive valid values.

pSacl

[out] Pointer to a pointer to an ACL. If a SACL exists, the function sets the pointer pointed to by pSacl to the address of the security descriptor's SACL. If a SACL does not exist, no value is stored.

If the function stores a NULL value in the pointer pointed to by pSacl, the security descriptor has a NULL SACL.

lpbSaclDefaulted

[out] Pointer to a flag set to the value of the SE_SACL_DEFAULTED flag in the SECURITY_DESCRIPTOR_CONTROL structure if a SACL exists for the security descriptor.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

Windows NT/2000/XP: Included in Windows NT 3.1 and later, Windows 2000, Windows XP, and Windows .NET Server 2003 family.
Windows 95/98/Me: Unsupported.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Advapi32.lib.

See Also

Low-Level Access-Control Overview, Low-Level Access Control Functions, GetSecurityDescriptorControl, GetSecurityDescriptorDacl, GetSecurityDescriptorGroup, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, InitializeSecurityDescriptor, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL, SetSecurityDescriptorSacl

Platform SDK Release: October 2002

What did you think of this topic? Let us know.

Order a Platform SDK CD Online (U.S./Canada)   (International)