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

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

Output

countA pointer to the number of items in the backing store. 

statusA 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

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_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(3dce).