UniBasic Commands Reference - Rocket Software

SQLSpecialColumns
Syntax
status = SQLSpecialColumns (statement.env, col.type, schema, owner, tablename,
IDscope, null)
Note: This function is case-sensitive. If you want it to be case-insensitive, you
must compile your programs using the BASIC command with the -i option.
Description
SQLSpecialColumns gets information about columns in a table.
SQLSpecialColumns lets applications scroll forward and backward in a result set to
get the most recent data from a set of rows. Columns returned for column type
SQL.BEST.ROWID are guaranteed not to change while positioned on that row.
Columns of the row ID can remain valid even when the cursor is not positioned on
the row. The application can determine this by checking the SCOPE column in the
result set.
Once the application gets values for SQL.BEST.ROWID, it can use these values to
reselect that row within the defined scope. The SELECT statement is guaranteed to
return either no rows or one row.
Columns returned for SQL.BEST.ROWID can always be used in an SQL select
expression or WHERE clause. However, SQLColumns does not necessarily return
these columns. If no columns uniquely identify each row in the table, SQLSpecial-
Columns returns a row set with no rows; a subsequent call to SQLFetch returns
SQL.NO.DATA.FOUND.
Columns returned for column type SQL.ROWVER let applications check if any
columns in a given row have been updated while the row was reselected using the
row ID.
If col.type, IDscope, or null specifies characteristics not supported by the data source,
SQLSpecialColumns returns a result set with no rows, and a subsequent call to
SQLFetch returns SQL.NO.DATA.FOUND.
SQLSpecialColumns 1-851