AtlGetDacl

 

Call this function to retrieve the discretionary access-control list (DACL) information of a specified object.

Important

This function cannot be used in applications that execute in the Windows Runtime.

Syntax

      inline bool AtlGetDacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CDacl* pDacl
) throw(   );

Parameters

  • hObject
    Handle to the object for which to retrieve the security information.

  • ObjectType
    Specifies a value from the SE_OBJECT_TYPE enumeration that indicates the type of object identified by the hObject parameter.

  • pDacl
    Pointer to a DACL object which will contain the retrieved security information.

Return Value

Returns true on success, false on failure.

Remarks

In debug builds, an assertion error will occur if either hObject or pDacl is invalid*.*

Requirements

Header: atlsecurity.h

See Also

Security Global Functions
AtlSetDacl
CDacl Class