dce_db_inq_count(3dce)

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

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)