int db::Table::open ( Database dbp,
const NameChar *  table_name,
CursorMode  cursor_mode = DB_CURSOR_FOR_READ,
TxIsolation  isolation = DB_DEFAULT_ISOLATION 
)

Open an existing table named table_name in the dbp database.

Parameters:
dbp The database in which to find the table. (required)
table_name The name of the table to open. (required)
cursor_mode The cursor mode to use.
isolation The isolation level to use in this cursor. If DB_DEFAULT_ISOLATION is selected, the isolation level of the transaction will be used (recommended).
Returns:
  • DB_NOERROR When successful.
  • DB_EINVAL Caused by: invalid table_name, invalid cursor_mode, or invalid transaction isolation mode.
  • DB_ENAME table_name is not in a valid format. Valid name is letter(aA-zZ)+zero or more aplhanumeric characters. Underscore is considered a valid character.
  • DB_ESTATE Object state is not compatible with the method called. Storage is already opened.
Postcondition:
The table is in DB_TABLE_BROWSING mode.


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