NAME
   dce_db_lock - Applies an advisory lock on a backing store

 SYNOPSIS
   #include <dce/dce.h>
   #include <dce/dbif.h>

   void dce_db_lock( dce_db_handle_t handle,
                     error_status_t *status );

 PARAMETERS

   Input

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

   Output

   status    A pointer to the completion status.  On successful
             completion, the routine returns error_status_ok.
             Otherwise, it returns an error.

 DESCRIPTION

   The dce_db_lock() routine acquires the lock associated with the
   handle.

   There is an advisory lock associated with each handle.  The routines
   for storing and deleting backing stores apply the lock before
   updating a backing store.  This routine provides a means to apply
   the lock for other purposes, such as iteration.

   Advisory locks allow cooperating threads to perform consistent
   operations on backing stores, but do not guarantee consistency;
   that is, threads may still access backing stores without using
   advisory locks, possibly resulting in inconsistencies.

 ERRORS

   db_s_already_locked
             An attempt was made to lock a backing store, but it
             was already locked.

   error_status_ok
             The call was successful.

 RELATED INFORMATION

   Functions: dce_db_delete
              dce_db_delete_by_name
              dce_db_delete_by_uuid
              dce_db_store
              dce_db_store_by_name
              dce_db_store_by_uuid
              dce_db_unlock