NAME

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

h

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

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

dce_attr_s_not_implemented

error_status_ok

RELATED INFORMATION

Functions: dce_attr_intro(3dce), sec_rgy_attr_sch_aclmgr_strings(3dce).