dced_server_delete(3dce)

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