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

 NAME
   sec_rgy_attr_sch_get_acl_mgrs - Retrieve the manager types of the
                                   ACLs protecting the objects dominated
                                   by a named schema

 SYNOPSIS

   #include  <dce/sec_rgy_attr_sch.h>

   void sec_rgy_attr_sch_get_acl_mgrs(
           sec_rgy_handle_t context,
           sec_attr_component_name_t schema_name,
           unsigned32 size_avail,
           unsigned32 *size_used,
           unsigned32 *num_acl_mgr_types,
           uuid_t acl_mgr_types[],
           error_status_t *status);

 PARAMETERS

   Input

   context
          An opaque handle bound to a registry server.  Use
          sec_rgy_site_open() to acquire a bound handle.

   schema_name
          Reserved for future use.

   size_avail
          An unsigned 32-bit integer containing the allocated length of
          the acl_manager_types[] array.

   Output

   size_used
          An unsigned 32-bit integer containing the number of output
          entries returned in the acl_mgr_types[] array.

   num_acl_mgr_types
          An unsigned 32-bit integer containing the number of types
          returned in the acl_mgr_types[] array. This may be greater
          than size_used if there was not enough space allocated by
          size_avail for all the manager types in the
          acl_manager_types[] array.

   acl_mgr_types[]
          An array of the length specified in size_avail to contain UUIDs
          (of type uuid_t) identifying the types of ACL managers protecting
          the target object.

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

 DESCRIPTION

   The sec_rgy_attr_sch_get_acl_mgrs() routine returns a list of the
   manager types protecting the schema object identified by context.

   ACL editors and browsers can use this operation to determine the ACL
   manager types protecting a selected schema object. Then, using the
   sec_rgy_attr_sch_aclmgr_strings() routine, they can determine how to
   format for display the permissions supported by that ACL manager type.

   Permissions Required

   The sec_rgy_attr_sch_get_acl_mgrs() routine requires the r permission
   on the attr_schema object.

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

 ERRORS

   sec_attr_unauthorized

   sec_attr_svr_unavailable

   sec_attr_no_memory

   error_status_ok

 RELATED INFORMATION

   Functions: sec_intro
              sec_rgy_attr_sch_aclmgr_strings