OSF DCE Application Development Guide--Core Components

The Extended Attribute API
28.2.2.1 The sec_rgy_attr_sch_create_entry( ) Call
The sec_rgy_attr_sch_create_entry( ) call creates a schema entry that defines an
attribute type in the attribute schema.
This call uses the sec_attr_schema_entry_t data type that completely defines the
schema entry, including the following:
• The attribute type name (generally used for interactive access) and UUID (generally
used for programmatic access). Note that attribute instances share the name and
UUID of their attribute type.
• The attribute’s encoding (described in Section 28.1.3). The encoding is specified as
an enumerator of type sec_attr_encoding_t. For some kinds of encodings,
additional data types are used to further specify the encoding information. These
additional data types, the kinds of encodings that require them, and the purpose of
the data types are listed in Table 28-1.
TABLE 28-1. Encodings and Required Data Types
_________________________________________________________________________________
Required Purpose of
Encoding Data Type Data Type
_________________________________________________________________________________
_________________________________________________________________________________
Defines the length of
attribute values
sec_attr_enc_bytes sec_attr_enc_bytes_t
_________________________________________________________________________________
Defines the length of
attribute values
sec_attr_enc_confidential_bytes sec_attr_enc_bytes_t
_________________________________________________________________________________
Defines the i18n codesetsec_attr_enc_i18n_data sec_attr_i18n_data_t
_________________________________________________________________________________
Defines the total number of
members in the attribute set
and the UUID of each
member
sec_attr_enc_attr_set sec_attr_enc_attr_set_t
_________________________________________________________________________________
Defines a single print stringsec_attr_enc_printstring sec_attr_enc_printstring_t
_________________________________________________________________________________
Defines an array of print
strings
sec_attr_enc_printstring_array sec_attr_enc_str_array_t
_________________________________________________________________________________
28.2.2.2 The sec_rgy_attr_sch_update_entry( ) Call
The sec_rgy_attr_sch_update_entry( ) call updates a schema entry that defines an
attribute type.
The schema entry components that can be modified are controlled by the ERA API and
the modify_parts parameter of the sec_rgy_attr_sch_update_entry() call.
To ensure that registry and access control data remains consistent, the ERA API allows
only the following schema entry components to be modified:
124245 Tandem Computers Incorporated 28− 11