Name

dced_server_modify_attributes - Modifies attributes for a DCE server’s configuration data

Synopsis

#include <dce/dced.h> void dced_server_modify_attributes(
dced_binding_handle_t dced_bh,
uuid_t ∗conf_uuid,
dced_attr_list_t ∗data,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies the dced binding handle for the srvrconf service on a specific host. 

conf_uuidSpecifies the UUID that dced uses to identify a server’s configuration data to be modified. 

dataSpecifies the attributes to be modified. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_server_modify_attributes() routine replaces a server’s attributes of its configuration data maintained by dced on a specific host.  This routine is typically called after a configuration is created with the dced_server_create() routine. 

A server’s configuration is manipulated in a server_t data structure, and the dced_server_modify_attributes() routine affects only the attributes member of this structure.  To change other server configuration data, you must first delete the configuration by using dced_server_delete(), and then create the configuration again by using dced_server_create(). 

Prior to calling dced_server_modify_attributes(), the application must have established a valid dced binding handle to the srvrconf service by calling either dced_binding_create() or dced_binding_from_rpc_binding(). 

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. 

error_status_ok

db_s_bad_index_type

db_s_iter_not_allowed

db_s_readonly

db_s_store_failed

dced_s_bad_binding

dced_s_not_found

sec_acl_invalid_permission

Related Information

dcecp Objects: server(8dce). 

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_object_read(3dce). 

Books: OSF DCE Application Development Guide