NAME

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(3dce), dce_db_iter_next_by_name(3dce), dce_db_iter_next_by_uuid(3dce), dce_db_iter_start(3dce).