Name

dced_server_delete - 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_bhSpecifies the dced binding handle for the srvrconf service on a specific host. 

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

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_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.  The routine does not delete the program from disk nor does it affect the server if the server 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 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

dcecp Objects: server(8dce). 

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_server_create(3dce), dced_server_modify_attributes(3dce). 

Books: OSF DCE Application Development Guide.