OSF DCE Application Development Guide--Core Components

OSF DCE Application Development Guide—Core Components
28.2.3.3 The sec_rgy_attr_sch_lookup_by_id( ) and
sec_rgy_attr_sch_lookup_by_name( ) Calls
The sec_rgy_attr_sch_lookup_by_id() call reads the attribute schema entry identified
by UUID. The output of the call is a sec_attr_schema_entry_t type that contains the
specified attribute type’s name, UUID, and characteristics. Generally, this call is used
for programmatic access.
For interactive access, use the sec_rgy_attr_sch_lookup_by_name() call. This call
returns the same information as the sec_rgy_attr_sch_lookup_by_id() call but specifies
the schema entry to read by name instead of by UUID.
28.2.4 Reading the ACL Manager Types
Two calls retrieve the ACL manager types that protect objects dominated by a named
schema:
• sec_rgy_attr_sch_get_acl_mgrs()
Retrieves the UUIDs of the ACL manager types protecting all objects in a named
schema.
• sec_rgy_attr_sch_aclmgr_strings()
Retrieves printable strings for each ACL manager type protecting objects in a named
schema. The strings contain the ACL manager type’s name, associated help
information, and supported permission bits.
28.3 Calls to Manipulate Attribute Instances
This section introduces the sec_attr_schema_t data type used by the calls that create
and update attribute instances and then describes the calls that create, modify, delete,
and read attribute instances. For all calls, the object whose attributes should be accessed
is identified by name and by the domain in which the object exists. (The domain
parameter is ignored for the Policy and the Replist objects.) Registry domains are
described in Chapter 27.
28.3.1 The sec_attr_t Data Type
The sec_attr_t data type is used in the calls that create and update attribute instances.
The data type consists of a value of type uuid_t that identifies the attribute to be
accessed by UUID and data type of sec_attr_value_t. The sec_attr_value_t data type
28−14 Tandem Computers Incorporated 124245