dced_server_modify_attributes(3dce)
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_bh
Specifies the dced binding handle for the srvrconf service on a specific host.
conf_uuid
Specifies the UUID that dced uses to identify a server's configuration data to be modified.
data
Specifies the attributes to be modified.
Output
status
Returns 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
Routines: dced_object_read(3dce)
dced_binding_from_rpc_binding(3dce)
dcecp objects: server(8dce)
Book: OSF DCE Application Development Guide - Core Components