PreviousNext

dce_db_delete_by_uuid(3dce)

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

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

key
A pointer to a UUID 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_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)