VMS Help DCE, dce_intro, dce_db_intro, dce_db_inq_count  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   dce_db_inq_count - Returns the number of items in a backing store

 SYNOPSIS

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

   void dce_db_inq_count( dce_db_handle_t handle,
                          unsigned32 *count,
                          error_status_t *status );

 PARAMETERS

   Input

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

   Output

   count     A pointer to the number of items in the backing store.

   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_inq_count() routine returns the number of items in the
   backing store that is identified by the handle parameter, which was
   obtained from dce_db_open().  It performs identically on backing
   stores that are indexed by UUID and those that are indexed by string.
   The count of items can be helpful when iterating through a backing
   store.

 ERRORS

   db_s_iter_not_allowed
             The function was called while an iteration, begun by
             dce_db_iter_start(), was in progress.  Determining the
             count is not allowed during iteration.

   error_status_ok
             The call was successful.

 RELATED INFORMATION

   Functions: dce_db_iter_next