int KISAMOpenTable(KHAND handle, char *szTable, char *szDict, char *szMode)
| Parameter | Type | Purpose |
| handle | KHAND | handle of table. This must have been previously allocated in a KISAMAllocHandle call. |
| SzTable | char * | table name |
| szDict | char * | dictionary name |
| szMode | char * | open mode |
This function opens a table on a handle previously allocated by KISAMAllocHandle. Both the table filename and its dictionary filename must be supplied. These are assumed to be relative to the current working directory.
The mode parameter szMode is one of 3 values
| "R" | Read only access |
| "W" | Read and write access |
| "X" | Exclusive access |
A table cannot be opened in mode "W" if another program already has it open in "X" mode and similarly a table cannot be opened in "X" mode if already opened elsewhere in "W" mode.
The table szTable stays open until a call to KISAMCloseTable however the dictionary table szDict is only opened temporarily to read the column information into memory.