CPrivateObjectSecurityDesc::ConvertToAutoInherit

Call this method to convert a security descriptor and its access-control lists (ACLs) to a format that supports automatic propagation of inheritable access-control entries (ACEs).

bool ConvertToAutoInherit(
   const CSecurityDesc* pParent,
   GUID* ObjectType,
   bool bIsDirectoryObject,
   PGENERIC_MAPPING GenericMapping 
) throw( );

Parameters

  • pParent
    Pointer to a CSecurityDesc object referencing the parent container of the object. If there is no parent container, this parameter is NULL.

  • ObjectType
    Pointer to a GUID structure that identifies the type of object associated with the current object. Set ObjectType to NULL if the object does not have a GUID.

  • bIsDirectoryObject
    Specifies whether the new object can contain other objects. A value of true indicates that the new object is a container. A value of false indicates that the new object is not a container.

  • GenericMapping
    Pointer to a GENERIC_MAPPING structure that specifies the mapping from each generic right to specific rights for the object.

Return Value

Returns true on success, false on failure.

Remarks

This method attempts to determine whether the ACEs in the discretionary access-control list (DACL) and system access-control list (SACL) of the current security descriptor were inherited from the parent security descriptor. It calls the ConvertToAutoInheritPrivateObjectSecurity function.

Requirements

Header: atlsecurity.h

See Also

Concepts

CPrivateObjectSecurityDesc Class

CPrivateObjectSecurityDesc Members