把数据源中的表名存储到 Visual FoxPro 临时表中。
语法
SQLTABLES(nConnectionHandle [, cTableTypes] [, cCursorName])
参数
nConnectionHandle
由 SQLCONNECT( ) 返回的、指向数据源的连接句柄。
cTableTypes
指定一个或多个表类型。有效的表类型有:“TABLE”、“
VIEW”、“SYSTEM TABLE”或任何有效的数据源特定表类型标识。cTableTypes 必须大写。如果要包含多个表类型列表,请用逗号分隔。
如果省略 cTableTypes 参数,或者 cTableTypes 是空字符串,则选定数据源中所有表名。
指定的表类型必须用单引号括起来。下面的示例演示了如何指定“VIEW”和“SYSTEM TABLE”表类型。
? SQLTABLES(handle, "'VIEW', 'SYSTEM TABLE'", "mydbresult")
cCursorName
指定 Visual FoxPro 临时表的名称,结果集合发送到该临时表。如果不包含临时表名,Visual FoxPro 将使用默认名“
SQLRESULT”。
下表显示临时表中的列:
列名 | 说明 |
TABLE_QUALIFIER | 表限定符标识 |
TABLE_OWNER | 表拥有者标识 |
TABLE_NAME | 数据字典中的表名。 |
TABLE_TYPE | 数据字典中的表类型 |
REMARKS | 表的说明 |
返回值类型
数值型
说明
如果成功创建临时表,SQLTABLES( ) 返回 1;如果仍在执行中,则返回 0。如果发生连接级的错误,返回 -1;发生环境级的错误,返回 -2。
SQLTABLES( ) 是既可以同步执行又可以异步执行的四个函数之一。SQLSETPROP( ) 的异步选项设置决定这些函数是同步执行还是异步执行。异步方式下,必须重复调用 SQLTABLES( )
,直到返回一个非“假”(.F.)值,“假”(.F.)值表示函数仍在执行。