VMS Help DCE_SECURITY, API Routines, sec_acl_calc_mask  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   sec_acl_calc_mask - Returns the sec_acl_type_mask_obj entry for the
                       specified ACL list

 SYNOPSIS

   #include <dce/daclif.h>

   void sec_acl_calc_mask(
           sec_acl_list_t *sec_acl_list,
           error_status_t *status);

 PARAMETERS

   Input/Output

   *sec_acl_list
         A pointer to a sec_acl_type_t  the specifies the number of ACLs of
         each ACL type.  The sec_acl_type_t data type distinguishes between
         the various types of ACLs an object can possess for a given
         manager.  In the file system, for example, most objects have only
         one ACL, controlling the access to that object, but objects that
         control the creation of other objects (sometimes referred to as
         "containers") may have more.  A directory, for example, can have
         ACLs to be used as initial values when member objects are created.
         Do not confuse ACL types with the permissions corresponding to
         different ACL manager types or with the ACL manager types them-
         selves.

   Output

   status
         A pointer to the completion status.  On successful completion, the
         routine returns error_status_ok.  Otherwise, it returns an error.

 DESCRIPTION

   The sec_acl_calc_mask() routine calculates and sets the
   sec_acl_e_type_mask_obj entry of the specified ACL list.  The value of
   the sec_acl_e_type_mask_obj entry is the union of the permissions of all
   ACL entries that refer to members of the File Group Class.

   This operation is performed locally, within the client.  The function
   does not check to determine if the manager to which the specified ACL
   list will be submitted supports the sec_acl_e_type_mask_obj entry type.
   The calling application must determine whether to call this routine,
   after obtaining the required, if any, POSIX semantics, via the
   sec_acl_get_mgr_types_semantics() routine.

 NOTES

   This call is provided in source code form.

 FILES
     SYS$COMMON:[DCE$LIBRARY]DACLIF.IDL
                The idl file from which dce/daclif.h was derived.

 ERRORS

   sec_acl_cant_allocate_memory
                Requested operation requires more memory than is available.

   error_status_ok
                The call was successful.

 RELATED INFORMATION

   Functions: sec_intro