This topic has not yet been rated - Rate this topic

AtlSetDacl

Visual Studio .NET 2003

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

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.