SQLTables
功能描述
返回存储在特定数据源中的表、目录或模式名称以及表类型的列表。 驱动程序将以结果集的形式返回该信息。
接口原型
RETCODE SQL_API
SQLTables(HSTMT StatementHandle,
SQLCHAR *CatalogName,
SQLSMALLINT NameLength1,
SQLCHAR *SchemaName,
SQLSMALLINT NameLength2,
SQLCHAR *TableName,
SQLSMALLINT NameLength3,
SQLCHAR *TableType,
参数说明
参数名 | 参数说明 |
---|---|
StatementHandle | 语句句柄。 |
CatalogName | Vastbase在实现此接口时没有用到该参数。 |
NameLength1 | Vastbase在实现此接口时没有用到该参数。 |
SchemaName | 模式名的字符串搜索模式。如果驱动程序支持某些表的模式,但不支持其他表的模式,例如当驱动程序从不同的dbms检索数据时,一个空字符串(“”)表示那些没有模式的表。 |
NameLength2 | *SchemaName的字符长度。 |
TableName | 表名的字符串搜索模式。这个参数不能是空指针 |
NameLength3 | *TableName的字符长度。 |
TableType | 要匹配的表类型列表。 注意SQL_ATTR_METADATA_ID语句属性对TableType参数没有影响。TableType是一个值列表参数,不管SQL_ATTR_METADATA_ID的设置如何。 |
NameLength4 | *TableType的字符长度。 |
返回
- SQL_SUCCESS:表示调用正确。
- SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
其他
无。