Name

dce_db_delete_by_uuid - Deletes an item from a UUID-indexed backing store

Synopsis

#include <dce/dce.h>
#include <dce/dbif.h> void dce_db_delete_by_uuid(
    dce_db_handle_t handle,
    uuid_t ∗key,
    error_status_t ∗status);

Parameters

Input

handleA handle, returned from dce_db_open(), that identifies the backing store being used. 

keyA pointer to a UUID that is the key to the item in the backing store. 

Output

statusA 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_uuid() 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 UUID, as selected by the db_c_index_by_uuid 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 UUID.

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_name(3dce), dce_db_open(3dce).