sec_rgy_attr_sch_get_acl_mgrs(3sec)
Retrieves 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
/usr/include/dce/sec_rgy_attr_sch.idl
The idl file from which dce/sec_rgy_attr_sch.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.
sec_attr_unauthorized
sec_attr_svr_unavailable
sec_attr_no_memory
error_status_ok
Related Information
Functions:
sec_rgy_attr_sch_aclmgr_strings(3sec)