Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AtlSetDacl

 

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

System_CAPS_importantImportant

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

Copy 

      inline bool AtlSetDacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CDacl& rDacl,
DWORD dwInheritanceFlowControl= 0
) throw(...);

hObject

Handle to the object for which to set security information.

ObjectType

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

rDacl

The DACL containing the new security information.

dwInheritanceFlowControl

The inheritance flow control. This value can be 0 (the default), PROTECTED_DACL_SECURITY_INFORMATION or UNPROTECTED_DACL_SECURITY_INFORMATION.

Returns true on success, false on failure.

In debug builds, an assertion error will occur if hObject is invalid, or if dwInheritanceFlowControl is not one of the three permitted values.

Requirements

Header: atlsecurity.h

Show: