| ## dce_db_delete_by_name(3dce) Deletes an item from a string-indexed backing store Synopsis #include <dce/dce.h> #include <dce/dbif.h> void dce_db_delete_by_name( dce_db_handle_t handle, char *key, error_status_t *status); Parameters Input handle A handle, returned from dce_db_open( ), that identifies the backing store being used. key A NULL-terminated string that is the key to the item in the backing store. Output status A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error code. Description The dce_db_delete_by_name( ) routine deletes an item from the backing store that is identified by the handle parameter, which was obtained from dce_db_open(~). It is a specialized deletion routine for backing stores that are indexed by name, as selected by the db_c_index_by_name bit in the flags parameter to dce_db_open( ) when the backing store was created. 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. db_s_del_failed The deletion did not occur. The global variable errno may indicate further information about the error. db_s_bad_index_type The backing store is not indexed by name. db_s_iter_not_allowed The function was called while an iteration, begun by dce_db_iter_start( ), was in progress. Deletion is not allowed during iteration. error_status_ok The call was successful. Related Information Functions: dce_db_delete(3dce) dce_db_delete_by_uuid(3dce) dce_db_open(3dce) ##