Synopsis:

       db_close(db_handle)

Arguments:

       db_handle - the database handle

Description:  This function closes a database handle prevously opened by a call to db_open().      It will also close any indexes associated with the DBF file and that have been opened with a call to db_ixopen().      Also all currently aquired record handles (retrieved through db_get() or db_append() calls) will be released and any locks removed from the DBF file.

Returns:  Returns 0 upon success or a negative error code.