Name

dce_attr_sch_get_acl_mgrs - Retrieves the manager types of the ACLs protecting the objects dominated by a named schema

Synopsis

#include  <dce/dce_attr_base.h> void dce_attr_sch_get_acl_mgrs(
dce_attr_sch_handle_t h,
unsigned32 size_avail,
unsigned32 ∗size_used,
unsigned32 ∗num_acl_mgr_types,
uuid_t acl_mgr_types[],
error_status_t ∗status);

Parameters

Input

hAn opaque handle bound to a schema object.  Use dce_attr_sch_bind() to acquire the handle. 

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

Output

size_usedAn 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. 

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

Description

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

ACL editors and browsers can use this operation to determine the ACL manager types protecting a selected schema object. 

Permissions Required

The dce_attr_sch_get_acl_mgrs() routine requires appropriate permissions on the schema object for which the ACL manager types are to be returned.  These permissions are managed by the target server. 

Files

/usr/include/dce/dce_attr_base.idl
The idl file from which dce/dce_attr_base.h was derived. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

dce_attr_s_not_implemented

error_status_ok

Related Information

Functions: dce_attr_intro(3dce).