VMS Help  —  DCE  DCE_INTRO, dce_attr_intro, dce_attr_sch_update_entry
 NAME
   dce_attr_sch_update_entry - Update 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

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

   modify_parts
          A 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

   status
          A 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 to make
   any changes to these components, the schema entry must be deleted
   (which deletes all attribute instances of that type) and recreated.
   These components are listed below:

     +  Attribute name
     +  Reserved flag
     +  Apply defaults flag
     +  Intercell action flag
     +  Trigger binding
     +  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

   SYS$COMMON:[DCE$LIBRARY]DCE_ATTR_BASE.IDL
                The idl file from which dce/dce_attr_base.h was derived.

 ERRORS

   dce_attr_s_bad_binding

   error_status_ok

 RELATED INFORMATION

   Functions: dce_attr_intro
              dce_attr_sch_delete_entry
              dce_attr_sch_create_entry
Close Help