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