NAME
   dce_db_iter_done - Frees the state associated with iteration

 SYNOPSIS

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

   void dce_db_iter_done( 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.

 DESCRIPTION

   The dce_db_iter_done() routine frees the state that permits
   iteration.  It should be called after an iteration through a
   backing store is finished.

   The iteration state is established by dce_db_iter_start().
   The routines for performing iteration over the items are
   dce_db_iter_next(), dce_db_iter_next_by_name(), and
   dce_db_iter_next_by_uuid().

 ERRORS

   error_status_ok
             The call was successful.

 RELATED INFORMATION

   Functions: dce_db_iter_next
              dce_db_iter_next_by_name
              dce_db_iter_next_by_uuid
              dce_db_iter_start