Name

dced_entry_remove - Removes a hostdata or keytab data entry from a dced service’s list of entries

Synopsis

#include <dce/dced.h> void dced_entry_remove(
dced_binding_handle_t dced_bh,
uuid_t ∗entry_uuid,
error_status_t ∗status);

Parameters

Input

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

entry_uuidSpecifies the UUID of the entry to be removed from the service. 

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_entry_remove() routine removes an entry from the hostdata or keytab service entry list of dced.  It does not remove the actual data stored in the file, but makes it inaccessible from a remote host by way of the dced’s user interfaces which include the dced API and the DCE control program, dcecp.  Each host service that maintains data also maintains a list of data entries.  A data entry contains a name, a UUID, a brief description, and a storage tag indicating the location of the actual data. 

To delete both the data and entry for the hostdata, keytab, or srvrconf services, use dced_hostdata_delete(), dced_keytab_delete(), or dced_server_delete(), respectively.  (The srvrexec service is maintained only by dced and the secval service does not maintain data, so you cannot remove data for these services.) 

Applications commonly obtain an entry by traversing the entry list using the dced_entry_get_next() routine with its associated cursor routines. 

Prior to calling the dced_entry_remove() routine, the application must have established a valid dced binding handle to the hostdata or keytab service by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine. 

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_del_failed

db_s_key_not_found

db_s_readonly

dced_s_bad_binding

dced_s_no_support

dced_s_not_found

sec_acl_invalid_permission

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_hostdata_delete(3dce), dced_initialize_cursor(3dce), dced_keytab_delete(3dce), dced_server_delete(3dce). 

Books: OSF DCE Application Development Guide.