SQLGetTypeInfo
功能描述
返回有关支持的数据类型的信息。驱动程序以 SQL 结果集的形式返回该信息。
接口原型
RETCODE SQL_API
SQLGetTypeInfo(HSTMT StatementHandle,
SQLSMALLINT DataType)
参数说明
参数名 | 参数说明 |
---|---|
StatementHandle | 结果集的语句句柄 |
DataType | SQL数据类型 |
返回
- SQL_SUCCESS:表示调用正确。
- SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
其他
SQLGetTypeInfo 将结果作为标准结果集返回,结果按 DATA_TYPE 排序,然后按数据类型映射到相应 ODBC SQL的紧密性。 数据源定义的数据类型优先于用户定义的数据类型。 因此,排序顺序不一定一致,但可以先通用化为DATA_TYPE,后跟TYPE_NAME升序。 例如,假设数据源定义了 INTEGER 和 COUNTER 数据类型,其中 COUNTER 是自动递增的,并且还定义了用户定义的数据类型 WHOLENUM。 这些数据类型将按 INTEGER、WHOLENUM 和 COUNTER 顺序返回,因为 WHOLENUM 紧密映射到 ODBC SQL 数据类型 SQL_INTEGER,而自动递增数据类型(即使数据源支持)不会紧密映射到 ODBC SQL 数据类型。
如果 DataType 参数指定的数据类型对驱动程序支持的 ODBC 版本有效,但驱动程序不支持该数据类型,则它将返回空的结果集。