| ## dced_server_delete(3dce) Deletes a DCE server's configuration data from dced Synopsis #include <dce/dced.h> void dced_server_delete( dced_binding_handle_t dced_bh, uuid_t *conf_uuid, 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 the server's configuration data to be deleted. 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_delete( ) routine deletes a server's configuration data from the server's dced. This routine removes a server from DCE control by making it incapable of starting via dced. It does not delete the program from disk nor does it affect the server if it is currently running. Prior to using dced_server_delete( ), the server configuration data must be created by an administrator using the dcecp server create operation or by an application that using dced_server_create( ). Prior to calling dced_server_delete( ), 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( ). Examples In the following example, a dced binding is created to the server configuration service on a host, and then an inquiry is made as to the UUID associated with a particular server. The dced_server_delete( ) routine is then used to delete the configuration. dced_binding_handle_t dced_bh; dced_string_t server_name; uuid_t srvrconf_id; error_status_t status; name_server(&server_name); /* application specific */ dced_binding_create("srvrconf@hosts/katharine", dced_c_binding_syntax_default, &dced_bh, &status); dced_inq_id(dced_bh, server_name, &srvrconf_id, &status); dced_server_delete(dced_bh, &srvrconf_id, &status); dced_binding_free(dced_bh, &status); 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_del_failed db_s_iter_not_allowed dced_s_bad_binding dced_s_not_found sec_acl_invalid_permission Related Information Routines: dced_server_create(3dce) dced_server_modify_attributes(3dce) dced_binding_create(3dce) dced_binding_from_rpc_binding(3dce) dcecp objects: server(8dce) Book: OSF DCE Application Development Guide - Core Components ##