CPrivateObjectSecurityDesc::Set

Call this method to modify a private object's security descriptor.

bool Set(
   SECURITY_INFORMATION si,
   const CSecurityDesc& Modification,
   PGENERIC_MAPPING GenericMapping,
   const CAccessToken& Token 
) throw( );
bool Set(
   SECURITY_INFORMATION si,
   const CSecurityDesc& Modification,
   ULONG AutoInheritFlags,
   PGENERIC_MAPPING GenericMapping,
   const CAccessToken& Token 
) throw( );

Parameters

  • si
    A set of bit flags that indicate the parts of the security descriptor to set. This value can be a combination of the SECURITY_INFORMATION bit flags.

  • Modification
    Pointer to a CSecurityDesc object. The parts of this security descriptor indicated by the si parameter are applied to the object's security descriptor.

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

  • Token
    Reference to the CAccessToken object for the client process on whose behalf the object is being created.

  • AutoInheritFlags
    A set of bit flags that control how access-control entries (ACEs) are inherited from pParent. See CreatePrivateObjectSecurityEx for more details.

Return Value

Returns true on success, false on failure.

Remarks

The second method, which permits specifying the object type GUID of the object or controlling how ACEs are inherited, is only available on systems running Windows 2000 and later.

Requirements

Header: atlsecurity.h

See Also

Concepts

CPrivateObjectSecurityDesc Class

CPrivateObjectSecurityDesc Members

SetPrivateObjectSecurity

CPrivateObjectSecurityDesc::Get