Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

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

FILES

/usr/include/dce/sec_rgy_attr_sch.idl

The idl file from which dce/sec_rgy_attr_sch.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_attr_no_memory

Unable to allocate memory.

sec_attr_svr_unavailable

Server is unavailable.

sec_attr_unauthorized

Unauthorized to perform this operation.

SEE ALSO

Functions: sec_rgy_attr_sch_aclmgr_strings().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index