db_result_t db_set_range ( db_cursor_t  hcursor,
db_row_t  low_row,
db_object_t  low_uobject,
db_fieldno_t  low_size,
db_row_t  high_row,
db_object_t  high_uobject,
db_fieldno_t  high_size 
)

Restrict a cursor to only access rows within a given range.

Parameters:
hcursor Cursor handle.
low_row Low row handle.
low_uobject Low bound object data.
low_size Low size.
high_row High row handle.
high_uobject High bound object data.
high_size High size.
Returns:
On failure, one of the following error codes is set:
  • DB_EINVAL Caused by: invalid cursor handle, invalid low row handle, invalid high row handle, low row is null, high row is null.

See also:
get_db_error, clear_db_error, Error Handling


Copyright © 2005-2008 ITTIA®. All rights reserved.