Name

dce_attr_sch_update_entry - Updates a schema entry

Synopsis

#include <dce/dce_attr_sch.h> void dce_attr_sch_update_entry(
dce_attr_sch_handle_t h,
dce_attr_schema_entry_parts_t modify_parts,
dce_attr_schema_entry_t ∗schema_entry,
error_status_t ∗status);

Parameters

Input

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

modify_partsA value of type dce_attr_schema_entry_parts_t that identifies the fields in the schema bound to by h that can be modified. 

schema_entry
A pointer to a dce_attr_schema_entry_t that contains the schema entry values for the schema entry to be updated. 

Output

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The dce_attr_sch_update_entry() routine modifies schema entries.  Only those schema entry fields set to be modified in the dce_attr_schema_entry_parts_t data type can be modified. 

Some schema entry components can never be modified.  Instead, in order to make any changes to these components, the schema entry must be deleted (which deletes all attribute instances of that type) and recreated.  The schema entry components that can never be modified are as follows:

       •Attribute name

       •Reserved flag

       •Apply defaults flag

       •Intercell action flag

       •Trigger types

       •Comment

Fields that are arrays of structures (such as acl_mgr_set and trig_binding) are completely replaced by the new input array.  This operation cannot be used to add a new element to the existing array. 

Permissions Required

The dce_attr_sch_update_entry() routine requires appropriate permissions on the schema object.  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

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. 

dce_attr_s_bad_binding

error_status_ok

Related Information

Functions: dce_attr_intro(3dce), dce_attr_sch_create_entry(3dce), dce_attr_sch_delete_entry(3dce).