db_result_t db_goto_bookmark ( db_cursor_t  hcursor,
const db_oid_t bookmark 
)

Set a cursor's current row from a bookmark.

Parameters:
hcursor Cursor handle.
bookmark Bookmark to go to.
Returns:
On failure, one of the following error codes is set:
  • DB_EINVAL Cursor handle is invalid or bookmark is null.

See also:
db_get_bookmark,
get_db_error, clear_db_error, Error Handling


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