ATL Library Reference
AtlGetDacl
Call this function to retrieve the discretionary access-control list (DACL) information of a specified object.
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.