ODBC 数据类型和API(VC)

目录

ODBC 数据类型
API 函数

---

ODBC 数据类型

ODBC SQL 数据类型

ODBC SQL 数据类型
SQL类型标识	SQL 92类型标识	类型描述
SQL_CHAR	CHAR(n)	定长字符串,其长度为n
SQL_VARCHAR	VARCHAR(n)	变长字符串,最大长度为n
SQL_LONGVARCHAR	LONG VARCHAR	变长字符串,最大长度取决于数据源
SQL_WCHAR	NCHAR(n)	定长Unicode字符串,其长度为n
SQL_WVARCHAR	VARNCHAR(n)	变长Unicode字符串,最大长度为n
SQL_WLONGVARCHAR	LONG WVARCHAR	变长Unicode字符串,最大长度取决于数据源
SQL_DECIMAL	DECIMAL(p,s)	精度为p,小数位为s的有符号,精度数值型,其最大精度由驱动程序定义的.(1<=p<=15;s<=p)
SQL_NUMERIC	NUMERIC(p,s)	精度为p,小数位为s的有符号,精度数值型,其最大精度由驱动程序定义的.(1<=p<=15;s<=p)[4]
SQL_SMALLINT	SMALLINT	精度为p,小数位为0的精确数值型 有符号:-32, 768<= n <=32, 767 无符号:0<=n<=65,535
SQL_INTEGER	INTEGER	进度为10,小数位为0的精度数值型 有符号:-231<=n<=231-1 无符号:0<=n<=232-1
SQL_REAL	REAL	二进制精度为24的有符号近似数值型 0或绝对值从10-38到1038
SQL_FLOAT	FLOAT	二进制精度至少为p的有符号近似数值型(最大精度由驱动程序定义)
SQL_DOUBLE	DOUBLE PRECISON	二进制精度为53的有符号近似数值型 0或绝对值从10-308到10308
SQL_BIT	BIT	一位二进制数
SQL_TINYINT	TINYINT	精度为3,小数位为0的精度数值型 l有符号-128<=n<=127 l无符号0<=n<=255
SQL_BIGINT	BIGINT	精度为19(有符号)或精度为20(无符号)的精度数值型 有符号: -263<=n<=263-1 无符号: 0<=n<=264-1
SQL_BINARY	BINARY(n)	长度为n的定长二进制数据
SQL_VARBINARY	VARBINARY(n)	最大长度为n的变长二进制数据,最大长度有用户定义
SQL_LONGVARBINARY	LONG VARBINARY	变长二进制类型,最大长度依赖数据源
SQL_TYPE_DATE	DATE	包含年,月,日码位并符合格林威治日期
SQL_TYPE_TIME	TIME(p)	包含小时,分钟和秒码位,小时有效值为00到23,分钟有效值为00到59,秒有效值为00到59,p表示秒的精度
SQL_TYPE_TIMESTAMP	TIMESTAMP,DATETIME	包含年,月,日,小时,分钟和秒码位,具体定语与DATA和TIME一致
SQL_INTERVAL_MONTH	INTERVAL MONTH(p)	两日期间月差数,p是其差数值的精度
SQL_INTERVAL_YEAR	INTERVAL YEAR(p)	两日期间年差数,p是其差数值的精度
SQL_INTERVAL_YERA_TO_MONTH	INTERVAL YEAR(p) TO MONTH	两日期间年月差数,p是其差数的精度
SQL_INTERVAL_DAY	INTERVAL DAY(p)	两日期间日的差数,p是其差数的精度
SQL_INTERVAL_HOUR	INTERVAL HOUR(p)	两日期/时间间小时差数,p是其差数精度
SQL_INTERVAL_MINUTE	INTERVAL MINUTE(p)	两日期/时间间分钟差数,p是其差数精度
SQL_INTERVAL_SECOND	INTERVAL SECOND(p,q)	两日期/时间间秒差数,p是其差数精度,q是其差值的秒精度
SQL_INTERVAL_DAY_TO_HOUR	INTERVAL DAY(p) TO HOUR	两日期/时间间日和小时差数,p是其差数精度
SQL_INTERVAL_DAY_TO_MINUTE	INTERVAL DAY(p) TO MINUTE	两日期/时间间日,小时和分钟差数,p是其差数精度
SQL_INTERVAL_DAY_TO_SECOND	INTERVAL DAY(p) TO SECOND(q)	两日期/时间间日,小时,分钟和秒差数,p是其差数精度,q是其差值的秒精度
SQL_INTERVAL_HOUR_TO_MINUTE	INTERVAL HOUR(p) TO MINUTE	两日期/时间小时和分钟差,p是其差数精度
SQL_INTERVAL_HOUR_TO_SECOND	INTERVAL HOUR(p) TO SECOND(q)	两日期/时间小时,分钟和秒差,p是其差数精度,q是其差值的秒精度
SQL_INTERVAL_MINUTE_TO_SECOND	INTERVAL MINUTE(p) TO SECOND (q)	两日期/时间间分钟和秒差,p是其差数精度,q是其差值的秒精度
SQL_GUID	GUID	固定长度的全局唯一标识

ODBC C 数据类型  

ODBC C 数据类型



















C语言数据类型名称
ODBC 数据类型定义
C语言实际类型



















SQL_C_CHAR
SQLCHAR *
unsigned char *



















SQL_C_SSHORT
SQLSMALLINT
short int



















SQL_C_USHORT
SQLUSMALLINT
unsigned short int



















SQL_C_SLONG
SQLINTEGER
long int



















SQL_C_ULONG
SQLUINTEGER
unsigned long int



















SQL_C_FLOAT
SQLREAL
float



















SQL_C_DOUBLE
SQLDOUBLE,SQLFLOAT
double




















SQL_C_BIT
SQLCHAR
unsigned char




















SQL_C_STINYINT
SQLSCHAR
signed char




















SQL_C_UTINYINT
SQLCHAR
unsigned char




















SQL_C_SBIGINT
SQLBIGINT
_int64




















SQL_C_UBIGINT
SQLUBIGINT
unsigned _int64




















SQL_C_BINARY
SQLCHAR *
unsigned char *




















SQL_C_BOOKMARK
BOOKMARK
unsigned long int




















SQL_C_VARBOOKMARK
SQLCHAR *
unsigned char *




















SQL_C_TYPE_DATE
SQL_DATE_STRUCT
 struct tagDATE_STRUCT {
     SQLSMALLINT year;
     SQLUSMALLINT month;
     SQLUSMALLINT day;
} DATE_STRUCT;





















SQL_C_TYPE_TIME

SQL_TIME_STRUCT

struct tagTIME_STRUCT {
     SQLUSMALLINT hour;
     SQLUSMALLINT minute;
     SQLUSMALLINT second;
} TIME_STRUCT;





















SQL_C_TYPE_TIMESTAMP

SQL_TIMESTAMP_STRUCT

struct tagTIMESTAMP_STRUCT {
     SQLSMALLINT year;
     SQLUSMALLINT month;
     SQLUSMALLINT day;
     SQLUSMALLINT hour;
     SQLUSMALLINT minute;
     SQLUSMALLINT second;
     SQLUINTEGER fraction;
} TIMESTAMP_STRUCT;





















SQL_C_NUMERIC

SQL_NUMERIC_STRUCT

struct tagSQL_NUMERIC_STRUCT {
     SQLCHAR precision;
     SQLSCHAR scale;
     SQLCHAR sign[g];
     SQLCHAR val[SQL_MAX_NUMERIC_LEN];
} SQL_NUMERIC_STRUCT;





















SQL_C_GUID

SQLGUID

struct tagSQLGUID {
DWORD Data1;
WORD Data2;
WORD Data3;
BYTE Data4[8];
} SQLGUID;

ODBC SQL 与 ODBC C 数据类型的转换(图中用圆点标出的交叉点为允许的类型转换,其中实心圆点标出的是默认的数据转换类型,空心圆点标出的是允许的数据转换类型(允许并不表明一定可以,例如 Char 类型可以转换为SQL_C_INTEGER , 但是并不是总能成功,当字符为 ’123’ 时可以转换为整数 123,而字符为 ’odbc’ 时就不能成功)):

---

ODBC API 函数

ODBC API函数总汇

ODBC API函数类型	函数名称	主要功能
句柄函数	SQLAllocHandle	分配句柄
	SQLFreeHandle	释放句柄
环境函数	SQLGetEnvAttr	获得环境属性
	SQLSetEnvAttr	设置环境属性
连接函数	SQLBrowseConnect	浏览连接属性
	SQLConnect	建立连接
	SQLDisconnect	断开连结
	SQLDriverConnect	使用数据源配置窗口建立连结
	SQLGetConnectAttr	获得连接属性
	SQLSetConnectAttr	设置连接属性
语句函数	SQLCancel	取消语句处理
	SQLFreeStmt	释放语句相关资源
	SQLGetStmtAttr	获得语句属性
	SQLSetStmtAttr	设置语句属性
光标函数	SQLCloseCursor	关闭光标
	SQLGetCursorName	获得光标名称
	SQLSetCursorName	设置光标名称
	SQLSetPos	设置光标位置
编目函数	SQLColumns	获得表中列名列表
	SQLColumnPrivileges	获得列及其权限列表
	SQLForeignKeys	获得表中外键列表
	SQLGetTypeInfo	获得数据源支持数据类型信息
	SQLProcedureColumns	获得存储过程结果集列名列表
	SQLProcedure	获得存储过程列表
	SQLPrimiryKeys	获得主键列表
	SQLSpecialColumn	获得指定表中相关字段信息
	SQLStastics	获得索引统计列表
	SQLTablePrivileges	获得表和其权限清单
	SQLTables	获得表,编目和表类型清单
描述符函数	SQLCopyDesc	实现描述符句柄间的复制
	SQLGetDescFeild	获得描述符记录中单个字段
	SQLGetDescRec	获得描述符记录中多个字段
列表函数	SQLBindCol	将数据缓冲区绑定到列
	SQLColAttribute	获得列属性
	SQLDescribeCol	获得列描述符信息
	SQLGetData	获得结果集某一列数据
参数函数	SQLBindParameter	将SQL语句内参数与缓冲区绑定
	SQLPutData	将数据发送到驱动程序
	SQLDescribeParam	获得SQL愈加内参数描述符信息
	SQLParamData	为SQLPutData提供参数值
结果函数	SQLMoreResults	确定指定语句是否有多个结果
	SQLNumResultCols	获得结果中的列数
	SQLRowCount	获得结果中的记录数
	SQLFetch	获取结果集中的下条记录
	SQLFetchScroll	获取结果集中指定的记录
SQL处理函数	SQLExecDirect	执行给定的SQL语句
	SQLExecute	执行使用参数设置好的SQL语句
	SQLPrepare	为执行准备一个SQL字符串
	SQLNativeSql	得到被驱动程序修改的SQL字符串
诊断函数	SQLGetDiagField	获得诊断数据结构的记录字段的当前值
	SQLGetDiagRec	返回诊断记录的多个字段的当前值
数据源与驱动程序信息函数	SQLDataSources	返回数据源信息
	SQLDrivers	获得驱动程序的描述和属性关键字
	SQLGetFunctions	获取某个驱动程序是否支持指定的ODBC函数的有关信息
	SQLGetInfo	获得与连接相关的驱动程序及数据源信息
	SQLBulkOperations	实现批量插入和批量书签操作
	SQLEndTran	标志事务结束,实现提交或滚回

创建数据源

SQLConfigDataSource

函数原型


BOOL SQLConfigDataSource(
HWND hwndParent,

WORD fRequest,

LPCSTR lpszDriver,

LPCSTR lpszAttributes
);






















参数


hwndParent


输入参数,指定父窗口句柄






















fRequest

输入参数,指定数据源操作类型

ODBC_ADD_DSN 添加新的用户数据源
ODBC_CONFIG_DSN 配置已存在的用户数据源
ODBC_REMOVE_DSN 删除已存在的用户数据源
ODBC_ADD_SYS_DSN 添加新的系统数据源
ODBC_CONFIG_SYS_DSN 配置已存在的系统数据源
ODBC_REMOVE_SYS_DSN 删除已存在的系统数据源
ODBC_REMOVE_DEFAULT_DSN 删除缺省数据源



























































lpszDriver


输入参数,指定数据库驱动程序描述






















lpszAttributes


输入参数,包含配置数据源所必须的一组关键字-值的列表
展开显示






关键字


属性值描述






















DSN


数据源名称






















FILEDSN


文件数据源名称






















DRIVER


数据驱动的描述.如SQL Server,ORACLE等






















UID


用户ID






















PWD


UID对应的口令,如果没有口令,也可以为空字符串(PWD = ;)






















SAVEFILE


保存维持当前成功连接的关键字属性值的.dsn文件名称






















DATABASE


数据库名称




















































































































 

句柄函数

SQLAllocHandle

函数原型


SQLRETURN SQLAllocHandle(
SQL SMALLINT HandleType,

SQLHANDLE InputHandle,

SQLHANDLE *OutputHandlePtr
);






















参数


HandleType

输入参数,指定分配句柄类型

SQL_HANDLE_ENV 分配的是环境句柄
SQL_HANDLE_DBC 分配的是数据库连接句柄
SQL_HANDLE_STMT 分配的是语句句柄
SQL_HANDLE_DESC 分配的是描述句柄



























































InputHandle


输入参数,指定分配新句柄的相关联的句柄具体值与HandleType相对应
展开显示






HandleType


InputHandle






















SQL_HANDLE_ENV


SQL_NULL_HANDLE






















SQL_HANDLE_DBC


连接所属的环境句柄






















SQL_HANDLE_STMT


语句所属的连接句柄






















SQL_HANDLE_DESC


描述所属的句柄连接




















































































































 






















OutputHandlePtr


输出参数,返回分配的句柄





















返回值



若返回SQL_SUCCESS 表示成功执行
若返回SQL_SUCCESS_WITH_INFO 表示成功执行并有返回信息
若返回SQL_INVALIB_HANDLE 表示无效句柄



























































SQLFreeHandle

函数原型

SQLRETURN SQLFreeHandle( SQLSMALLINT HandleType,SQLHANDLE Handle
);






















参数


HandleType

要分配的句柄类型.UltraLite 支持以下句柄类型：

SQL_HANDLE_ENV
SQL_HANDLE_DBC
SQL_HANDLE_STMT



























































Handle


要释放的句柄






















注释


当不再需要句柄时,应该对每个使用 SQLAllocHandle 分配的句柄调用 SQLFreeHandle

环境句柄

SQLGetEnvAttr

函数原型

SQLRETURN SQLGetEnvAttr(
SQLHENV EnvironmentHandle,

SQLINTEGER Attribute,

SQLPOINTER ValuePtr,

SQLINTEGER BufferLength,

SQLINTEGER *StringLength
);






















参数


EnvironmentHandle


输入参数,指定获得环境属性的环境句柄






















Attribute


输入参数,指定要获得的环境属性






















ValuePtr


输出参数,指定存放要获得的环境属性值的缓冲区指针






















BufferLength


输入参数,指定ValuePtr指向字符串或二进制缓冲区数据的长度






















StringLength


输出参数,指定存放ValuePtr时间长度的缓冲区的指针






















SQLSetEnvAttr

函数原型


SQLRETURN SQLSetEnvAttr(
SQOHENV EnvironmentHandle,

SQLINTEGER Attribute,

SQLPOINTER ValuePtr,

SQLINTEGER StringLength
);






















参数


EnvironmentHandle


输入参数,指定设置环境属性的环境句柄






















Attribute


输入参数,指定设置的环境属性






















ValuePtr


输入参数,指定要设置的环境属性值






















StringLength 
 


输入参数,指定ValuePtr指向字符串或二进制缓冲区数据的长度,如果ValuePtr指向其他数据类型,则忽略此参数

连接函数

SQLConnect

函数原型


SQLRETURN SQLConnect(
SQLHDBC ConnectionHandle.
SQLCHAR* ServerName,

SQLSMALLINT NameLength1,

SQLCHAR* UserName,

SQLSMALLINT NameLength2,

SQLCHAR* Authentication,

SQLSMALLINT NameLength3
);






















参数


ConnectionHandle


输入参数,指定建立连接的连接句柄






















ServerName


输入参数,指定建立连接的数据源名称






















NameLength1


输入参数,指定*ServerName的长度






















UserName


输入参数,指定建立连接采用的用户ID






















NameLength2


输入参数,指定*UserName的长度






















Authentication


输入参数,指定此用户的密码






















NameLength3


输入参数,指定*Authentication的长度






















SQLBrowseConnect


函数格式


SQLRETURN SQLBrowseConnect(
SQLHDBC ConnectionHandle,

SQLCHAR* InConnectionString,

SQLSMALLINT StringLength1,

SQLCHAR* OutConnectionString,

SQLSMALLINT BufferLength,

SQLSMALLINT*StringLength2Ptr
);






















参数


ConnectionHandle


输入参数,指定建立连接的连接句柄






















InConnectionString


输入参数,指定了连接字符串,该字符串可以为完全连接串,部分连接串或空字符串






















StringLength1


输入参数,指定InConnectionString指向的缓冲区的字节长度






















OutConnectionString


输出参数,返回存放完全连接串的缓冲区的指针






















BufferLength


输入参数,指定OutConnectionString指向的缓冲区的字节长度






















StringLength2Ptr


输出参数,返回指向OutConnectionString缓冲实际的长度





















说明


此函数除了具有其他ODBC API所具有的返回值外,它还有一个比较特别的SQL_NEED_DATA.它表明SQLBrowseConnect函数的连接字符串未获得足够的连接属性,仍需继续迭代.如果返回SQL_SUCCESS或SQL_SUCCESS_WITH_INFO时,说明应用程序已经成功建立了与数据源的连接






















SQLDriverConnect

函数原型


SQLRETURN SQLDriverConnect(
SQLHDBC ConnectionHandle,

SQLHWND WindowHandle,

SQLCHAR* InConnectionString ,

SQLSMALLINT StringLength1,

SQLCHAR* OutConnectionString,

SQLSMALLINT BufferLength,

SQLSMALLINT* StringLength2Ptr,

SQLUSMALLINT DriverCompletion
);






















参数


ConnectionHandle


输入参数,指定建立连接的连接句柄






















WindowHandle


输入参数,指定建立数据连接的父窗口句柄






















InConnectionString


输入参数,指定了连接字符串.该字符串可以为完全连接串,部分连接串或空字符串






















StringLength1


输入参数,指定InConnectionString指向的缓冲区的字节长度






















OutConnectionString


输出参数,返回存放网球连接串的缓冲区的指针






















BufferLength


输入参数指定了OutConnectionString指向的缓冲区的字节长度






















StringLength2Ptr


输出参数,返回指向OutConnectionString缓冲区实际的长度






















DriverCompletion



输入参数,指定函数执行的标志

SQL_DRIVER_PROMPT 如果连接字符串未包括 Driver,DSN,FileDSN 关键字,系统会自动弹出 Data Source 窗口
SQL_DRIVER_COMPLETE 和 SQL_DRIVER_COMPLETE_REQUIRED 如果指定数据源,则应用程序使用此数据源,否则,系统弹出 Data Source 窗口
SQL_DRIVER_NOPROMPT使用指定的数据源,不弹出Data Source窗口






























































SQLSetConnectAttr

函数原型


SQLRETURN SQLSetConnectAttr(SQLHDBC     ConnectionHandle,

     SQLINTEGER     Attribute,

     SQLPOINTER     ValuePtr,

     SQLINTEGER     StringLength
);






















参数


ConnectionHandle


提供DBC连接句柄






















Attribute


指定需要设置的属性类型,在这里设置为值SQL_ATTR_AUTOCOMMIT,需要强制转换位指针类型






















ValuePtr


提供参数值






















StringLength


指定参数的长度,当参数为整数是设置为SQL_IS_INTEGER,当参数为字符串时设置为字符串长度或者为SQL_NTS






















SQLDisconnect

函数原型


SQLRETURN SQLDisconnect(SQLHDBC     ConnectionHandle
);





















参数


ConnectionHandle 


要关闭的连接的句柄

语句函数

SQLCancel

函数原型


SQLRETURN SQLCancel( SQLHSTMT     StatementHandle);





















参数


StatementHandle


语句句柄






















SQLSetStmtAttr

函数原型


SQLRETURN SQLSetStmtAttr(
     SQLHSTMT     StatementHandle,

     SQLINTEGER     Attribute,

     SQLPOINTER     ValuePtr,

     SQLINTEGER     StringLength
);






















参数


ConnectionHandle


提供STMT连接句柄






















Attribute


指定需要设置的属性类型






















ValuePtr


提供参数值






















StringLength


指定参数的长度,当参数为整数是设置为SQL_IS_INTEGER,当参数为字符串时设置为字符串长度或者为SQL_NTS






















这里讲一下常用的参数Attribute可能的取值和ValuePtr对应的取值
展开显示






Attribute


ValuePtr


作用






















SQL_ATTR_ASYNC_ENABLE


整数,取值为：SQL_ASYNC_ENABLE_OFF,SQL_ASYNC_ENABLE_ON


是否使用异步执行功能






















SQL_ATTR_QUERY_TIMEOUT


设置一个合法的整数


SQL语句执行时的超时秒数,设置为0表示无超时






















SQL_ATTR_CURSOR_TYPE


整数,取值为：SQL_CURSOR_FORWARD_ONLY, SQL_CURSOR_STATIC, SQL_CURSOR_DYNAMIC, SQL_CURSOR_KEYSET_DRIVEN


设置光标的类型




















































































































 

编目函数

SQLColumns

函数原型


SQLRETURN SQLColumns(
SQLHSTMT StatementHandle,

SQLCHAR* ,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* TableName,

SQLSMALLINT NameLength3,

SQLCHAR* ColumnName,

SQLSMALLINT NameLenght4
);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLength2


输入参数,指定*SchemaName参数的长度






















TableName


输入参数,指定表名






















NameLength3


输入参数,指定*TableName参数长度






















ColumnName


输入参数,指定列名






















NameLenght4


输入参数,知道你该*ColumnName参数长度





















返回值


获得指定表中的列信息,驱动返回此结果集






















SQLForeignKeys

函数原型


SQLRETURN SQLForeignKeys(
SQLHSTMT StatementHandle,

SQLCHAR* PKCatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* PKSchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* PKTableName,

SQLSMALLINT NameLength3,

SQLCHAR* FKCatalogName,

SQLSMALLINT NameLength4,

SQLCHAR* FKSchemaName,

SQLSMALLINT NameLength5,

SQLCHAR* FKTableName,

SQLSMALLINT 
);






















参数


StatementHandle


输入参数,指定语句句柄






















PKCatalogName


输入参数,指定主键表编目名






















NameLength1


输入参数,指定*PKCatalogName参数长度






















PKSchemaName


输入参数,指定对主键对纲要字符串搜索的模式






















NameLength2


输入参数,指定*PKSchemaName参数的长度






















PKTableName


输入参数,指定主键表名






















NameLength3


输入参数,指定*PKTableName参数长度






















FKCatalogName


输入参数,指定外键表编目名






















NameLength4


输入参数,指定*FKCatalogName参数长度






















FKSchemaName


输入参数,指定对外键对纲要字符串搜索的模式






















NameLength5


输入参数,*FKSchemaName参数的长度






















FKTableName


输入参数,指定外键表名






















NameLength6


输入参数,指定*FKTableName参数长度





















返回值


此函数返回两部分信息,指定表中的外键列表和参考指定表主键的其他表的外键列表,驱动器将每一部分列表作为一个结果集返回






















SQLGetTypeInfo

函数原型


SQLRETURN SQLGetTypeInfo(
SQLHSTMT StateMentHandle,SQLSMALLINT DataType
);





















参数


StatementHandle


输入参数,指定语句句柄






















DataType


输入参数,指定数据类型





















返回值


返回指定数据源支持的所有数据类型的列表,驱动器返回此结果集






















SQLProcedureColumns

函数原型


SQLRETRUN SQLProcedureColumns(
SQLHSTMT StatementHandle,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLenght2,

SQLCHAR* ProcName,

SQLSMALLINT NameLenght3,

SQLCHAR* ColumnName,

SQLSMALLINT NameLength4,

);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLength2


输入参数,指定*SchemaName参数的长度






















ProcName


输入参数,指定存储过程名






















NameLength3


输入参数,指定*ProcName参数长度






















ColumnName


输入参数,指定列名






















NameLength4


输入参数,指定*ColumnName参数长度





















返回值


返回指定存储过程的输入,输出参数列表及存储过程结果集的列的列表,驱动返回此结果集






















SQLProcedure

函数原型


SQLRETURN SQLProcedure(
SQLHSTMT StatementHandle,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* ProcName,

SQLSMALLINT NameLength3
);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLength2


输入参数,指定*SchemaName参数的长度






















ProcName


输入参数,指定存储过程名






















NameLength3


输入参数,指定*ProcName参数长度





















返回值


返回数据源中所有存储过程列表,驱动器返回此结果集






















SQLPrimiryKeys

函数原型


SQLRETURN SQLPrimaryKeys(
SQLHSTMT StatementHandle,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLenght2,

SQLCHAR* TableName,

SQLSMALLINT ,

);






















参数


StatementHandle
 


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLenght2


指定*SchemaName参数长度






















TableName


输入参数,指定表名






















NameLength3


输入参数,指定*TableName参数长度





















返回值


获得构成指定表的主键列名,驱动器返回此结果集,此函数不支持在一次调用获得多表的主键信息






















SQLSpecialColumn

函数原型


SQLRENTURN SQLSpecialColumns(
SQLHSTMT StatementHandle,

SQLSMALLINT IdentifierType,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* TableName,

SQLSMALLINT NameLenght3,

SQLSMALLINT Scope,

SQLSMALLINT Nullable
);






















参数


StatementHandle


输入参数,指定语句句柄






















IdentifierType


输入参数,中返回字段类型取值为
l SQL_BEST_ROWID返回能使指定表中的任何行被唯一标示的列或列集
l SQL_ROWVER返回指定表中任意值被事务更新时自动更新的列或列集






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定指定对纲要字符串搜索的模式






















NameLength2


输入参数,指定*SchemaName参数长度






















TableName


输入参数,指定表名






















NameLenght3


输入参数,指定*TableName参数长度






















Scope


输入参数,指定行标识符最小范围,其取值参考表为
展开显示
Scope取值


含义






















SQL_SCOPE_CURROW


仅当定位于改行时,
该行标识符有效






















SQL_SCOPE_TRANSACTION


在当前事务期间,
改行标识符有效






















SQL_SCOPE_SESSION


在回话(跨事务边界)期间,
该行标识符有效






































 






















Nullable


输入参数,指定是否返回包含空值的列,如果该参数取SQL_NO_NULLS.则不包含空值的列,如果取值为SQL_NULLABLE即使列为空值,也将被返回





















返回值


返回指定表的特殊列的列表,具有唯一标识的列,行中任意值被事务更新的列,驱动器返回此结果






















SQLStastics

函数原型


SQLRETURN SQLStatistics(
SQLHSTMT StatementHandle,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* TableName,

SQLSMALLINT NameLength3,

SQLSMALLINT Unique,

SQLSMALLINT Reserved
);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLength2


输入参数,指定*SchemaName参数长度






















TableName


输入参数,指定表名






















NameLength3


输入参数,指定TableName参数长度






















Unique


输入参数,指定了索引类型,取值为两种SQL_INDEX_UNIQUE(唯一索引)和SQL_INDEX_ALL(任何索引)






















Reserved


输入参数,指定结果集中CANDINALITY和PAGES列的重要性.取值如下:
l SQL_ENSURE:请求驱动程序无条件取回统计情况,该选项仅仅遵从X/Open标准,不支持ODBC扩展的驱动程序不能使用SQL_ENSURE该选项
l SQL_QUICK请求驱动程序仅仅取回CANDINALITY和PAGES此时,驱动程序不能确保取回的是当前值





















返回值


返回指定表所有的索引统计列表,驱动器返回此结果集






















SQLTablePrivileges

函数原型


SQLTablePrivileges
SQLRETURN SQLTablePrivileges(
SQLHSTMT StatementHandle,

SQLCHAR* CatalogName,

SQLSMALLINT NameLength1,

SQLCHAR* SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR* TableName,

SQLSMALLINT NameLength3
);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLength1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串收拾的模式






















NameLength2


输入参数,指定*SchemaName参数的长度






















TableName


输入参数,指定表名






















NameLength3


输入参数,指定*TableName参数的长度





















返回值


返回指定数据源中表及其对应权限的列表,驱动器以结果显示返回






















SQLTables

函数原型


SQLRETURN SQLTables(
SQLHSTMT *StatementHandle,

SQLCHAR *CatalogName,

SQLSMALLINT NameLenght1,

SQLCHAR *SchemaName,

SQLSMALLINT NameLength2,

SQLCHAR *TableName,

SQLSMALLINT NameLenght3,

SQLCHAR *TableType,

SQLSMALLINT NameLenght4
);






















参数


StatementHandle


输入参数,指定语句句柄






















CatalogName


输入参数,指定编目名称






















NameLenght1


输入参数,指定*CatalogName参数长度






















SchemaName


输入参数,指定对纲要字符串搜索的模式






















NameLenght2


指定*SchemaName参数的长度






















TableName


输入参数,指定表名






















NameLenght3


输入参数,指定TableName参数长度






















TableType


输入参数,指定表类型






















NameLenght4


输入参数,指定*TableType参数长度





















返回值


该函数返回存储在指定数据源中的表,编目或模式,表类型的表单,驱动器返回此结果集

列表函数

SQLDescribeCol

函数原型


SQLRETURN SQLDescribeCol(
     SQLHSTMT     StatementHandle,

     SQLSMALLINT     ColumnNumber,

     SQLCHAR *     ColumnName,

     SQLSMALLINT     BufferLength,

     SQLSMALLINT *     NameLengthPtr,

     SQLSMALLINT *     DataTypePtr,

     SQLUINTEGER *     ColumnSizePtr,

     SQLSMALLINT *     DecimalDigitsPtr,

     SQLSMALLINT *     NullablePtr
);






















参数


StatementHandle


输入参数,语句句柄






















ColumnNumber


输入参数,需要得到的列的序号,从1开始计算






















ColumnName


输出参数,得到列的名称






















BufferLength


输入参数,指明ColumnName参数的最大长度






















NameLengthPtr


输出参数,返回列名称的长度






















DataTypePtr


输出参数,得到列的ODBC数据类型






















ColumnSizePtr


输出参数,得到列的长度






















DecimalDigitsPtr


输出参数,当该列为数字类型时返回小数点后数据的位数






















NullablePtr


输出参数,指明该列是否允许为空值






















SQLBindCol

函数原型


SQLRETURN SQLBindCol(
     SQLHSTMT     StatementHandle,

     SQLUSMALLINT     ColumnNumber,

     SQLSMALLINT     TargetType,

     SQLPOINTER     TargetValuePtr,

     SQLINTEGER     BufferLength,

     SQLLEN *     StrLen_or_Ind
);






















参数


StatementHandle


输入参数,语句句柄






















ColumnNumber


输入参数,列的位置,如果用户使用书签(BookMark),也就是设置语句句柄属性为SQL_ATTR_USE_BOOKMARKS时,列号的基号为0,0表示书签,如果用户不使用书签,设置语句句柄为SQL_UB_OFF时,其基值为1,它们的顺序是按记录集中返回列的顺序递增的






















TargetType


输入参数,指用于参数绑定C语言数据类型,当调用SQLFetch,SQLFetchScroll,SQLBulkOperator,SQLSetPos等函数从数据源检索数据时,驱动程序将数据类型换行为此类型;当调用SQLBulkOperator,SQLSetPos等函数将数据发送到数据源时,驱动程序将数据装潢成数据源对应的数据类型






















TargetValuePtr


延迟输入/输出参数,为绑定列数据缓冲区指针,如果其值为空指针,则驱动程序会解除列于数据缓冲区的绑定,但长度/指示器缓冲区与此列绑定,也就是说,如果TargeValuePtr为空指针,后面的参数StrLen_or_IndPtr仍然保存为此列的长度/指示器缓冲区指针






















BufferLength


输入参数,指明参数指针所指向的缓冲区的字节数大小.对于字符串和结构需要指明大小,而对于普通的变量如SQLINTEGER,SQLFLOAT等设置为0就可以了






















StrLen_or_IndPtr


延迟输入/输出参数,返回拷贝的缓冲区的数据的字节数






















SQLColAttribute

函数原型


SQLRETURN SQLColAttribute(
SQLHSTMT StatementHandle,

SQLUSMALLINT ColumnNumber,

SQLUSMALLINT FieldIdentifier,

SQLPOINTER CharacterAttributePtr,

SQLSMALLINT BufferLength,

SQLSMALLINT *StringLengthPtr,

SQLPOINTER NumericAttributePtr
);






















参数


StatementHandle


输入参数,指定了相应的语句句柄






















ColumnNumber


输入参数,指定IRD中要检索的字段值的列号,列号的基值为1,并按记录集返回列的顺序,顺序递增






















FieldIdentifier


输入参数,指定要返回值的行号






















CharacterAttributePtr


输出参数,如果输出字符串,存放相应记录纸的缓冲区的指针






















BufferLength


输入参数,指定缓冲区的长度






















StringLengthPtr


输出参数,输出时间缓冲区的长度






















NumericAttributePtr


输出参数,如果输出参数为数组,存放相应记录值的缓冲区指针






















SQLGetData

函数原型


SQLRETURN SQLGetData(
     SQLHSTMT     StatementHandle,

     SQLUSMALLINT     ColumnNumber,

     SQLSMALLINT     TargetType,

     SQLPOINTER     TargetValuePtr,

     SQLINTEGER     BufferLength,

     SQLINTEGER *     StrLen_or_IndPtr
);






















参数


StatementHanlde


STMT句柄






















ClumnNumber


列号,以1开始






















TargetType


数据缓冲区（TargetValuePtr）的C语言数据类型






















TargetValuePtr


获得此列数据的数据存放的地址






















BufferLength


数据缓冲区（TargetValuePtr）的长度






















StrLen_or_IndPtr


返回当前得到的字段的字节长度





















说明


SQLGetData的另一个用处就是用于得到一些变长字段的实际长度,例如VARCHAR字段,TEXT字段.例如：
SQLGetData(hstmt,2,SQL_C_CHAR,szName,0,&cbName);
当你将 BufferLength 参数置为0,则会在 StrLen_or_IndPtr 参数中返回字段的实际长度.但请注意第四个参数必须是一个合法的指针,不能够为NULL

参数函数

SQLBindParameter

函数原型


SQLRETURN SQLBindParameter(
     SQLHSTMT     StatementHandle,

     SQLUSMALLINT     ParameterNumber,

     SQLSMALLINT     InputOutputType,

     SQLSMALLINT     ValueType,

     SQLSMALLINT     ParameterType,

     SQLUINTEGER     ColumnSize,

     SQLSMALLINT     DecimalDigits,

     SQLPOINTER     ParameterValuePtr,

     SQLINTEGER     BufferLength,

     SQLINTEGER *     StrLen_or_IndPtr
);






















参数


StatementHandle


执行SQL语句STMT句柄






















ParameterNumber


指明要将变量与第几个参数绑定,从1开始计算






















InputOutputType


指明是输入还是输出参数.可以取值的范围为：SQL_PARAM_INPUT,SQL_PARAM_OUTPUT ,SQL_PARAM_INPUT_OUTPUT






















ValueType


指明用于和参数绑定的C语言数据类型






















ParameterType


指明在存储过程中ODBC数据类型






















ColumnSize


指明接收数据的宽度,对于字符串和结构需要指明数据的宽度,而对于普通的变量如SQLINTEGER,SQLFLOAT等设置为0就可以了






















DecimalDigits


当数据类型为SQL_NUMERIC,SQL_DECIMAL时指明数字小数点的精度,否则填0






















ParameterValuePtr


在作为输入参数指明参数的指针,在作为输出参数时指明接收数据的变量指针






















BufferLength


指明参数指针所指向的缓冲区的字节数大小.对于字符串和结构需要指明大小,而对于普通的变量如SQLINTEGER,SQLFLOAT等设置为0就可以了






















StrLen_or_IndPtr


作为输入参数时指明数据的字节数大小,对于普通的定长变量如SQLINTEGER,SQLFLOAT等设置为0就可以了,对于字符号串需要在此参数中指定字符串数据的长度,或者设置为SQL_NULL_DATA表明此参数为空值,或者设置为SQL_NTS表明字符串以NULL字符结尾,对于结构需要指明结构的长度.当作为输出参数时,当SQL执行完毕后会在这个参数中返回拷贝的缓冲区的数据的字节数

结果集函数

SQLNumResultCols

函数原型


SQLRETURN SQLNumResultCols(
SQLHSTMT StatementHandle,

SQLSMALLINT *ColumnCountPtr
);






















参数


StatementHandle


STMT句柄






















ColumnCountPtr


返回列数






















SQLDescribeCol

函数原型


SQLRETURN SQLDescribeCol(SQLHSTMT     StatementHandle,

     SQLSMALLINT     ColumnNumber,

     SQLCHAR *     ColumnName,

     SQLSMALLINT     BufferLength,

     SQLSMALLINT *     NameLengthPtr,

     SQLSMALLINT *     DataTypePtr,

     SQLUINTEGER *     ColumnSizePtr,

     SQLSMALLINT *     DecimalDigitsPtr,

     SQLSMALLINT *     NullablePtr
);






















参数


StatementHandle


STMT句柄






















ColumnNumber


需要得到的列的序号,从1开始计算






















ColumnName


得到列的名称






















BufferLength


指明ColumnName参数的最大长度






















NameLengthPtr


返回列名称的长度






















DataTypePtr


得到列的ODBC数据类型






















ColumnSizePtr


得到列的长度






















DecimalDigitsPtr


当该列为数字类型时返回小数点后数据的位数






















NullablePtr


指明该列是否允许为空值






















SQLRowCount

函数原型


SQLRETURN SQLRowCount(SQLHSTM StatementHandle,SQLINTEGER*  RowCountPtr);






















参数


StatementHandle


STMT句柄






















RowCountPtr


获得结果集的缓冲区





















说明


你可以通过SQLExecDirect执行SQL语句来插入,修改和删除数据,在执行插入,修改和删除的SQL语句后就可以通过SQLRowCount函数来得到被影响的数据的行数.
Insert into test_t1 values(4, '2002-1-4 11:25' , 'user_4',1.86 );






















SQLFetch

函数原型


SQLRETURN SQLFetch(SQLHSTMT StatementHandle);





















参数


StatementHandle


STMT句柄





















说明


在你调用SQLExecDirect执行SQL语句后,你需要遍历结果集来得到数据.StatementHandle是STMT句柄,此句柄必须是被执行过.
当调用SQLFetch 函数后,光标会被移动到下一条记录处,当光标移动到记录集的最后一条,函数将会返回SQL_NO_DAT






















SQLFetchScroll

函数原型


SQLRETURN SQLFetchScroll( SQLHSTMT StatementHandle,SQLSMALLINT FetchOrientation,SQLINTEGER FetchOffset
);






















参数


StatementHandle


STMT句柄






















FetchOrientation


表明滚动的方式,允许的值如下
展开显示






FetchOrientation


含义






















SQL_FETCH_NEXT


滚动到下一行,这时候调用相当与SQLFetch,参数FetchOffset将被忽略






















SQL_FETCH_PRIOR


滚动到上一行,参数FetchOffset将被忽略






















SQL_FETCH_FIRST


滚动到第一行,参数FetchOffset将被忽略






















SQL_FETCH_LAST


滚动到最后一行,参数FetchOffset将被忽略






















SQL_FETCH_ABSOLUTE


滚动到参数FetchOffset指定的绝对行






















SQL_FETCH_RELATIVE


由当前位置滚动到参数FetchOffset指定的相对行,FetchOffset大于0表示向前滚动,FetchOffset小于0表示向后滚动




















































































































 






















FetchOffset


表明光标滚动的位置





















说明


光标滚动后,获取数据的方法和SQLFetch相同.滚动时如果指定的位置超出结果集区域会返回错误

SQL处理函数

SQLExecDirect	函数原型	SQLRETURN SQLExecDirect( SQLHSTMT StatementHandle,SQLCHAR *StatementText,SQLINTEGER TextLength );
	参数	StatementHandle	输入参数,设置要执行的语句
		StatementText	输入参数,设置要执行的SQL语句
		TextLength	输入参数,指定*StatementText缓冲区的长度
SQLPrepare	函数原型	SQLRETURN SQLPrepare( SQLHSTMT StatementHandle,SQLCHAR* StatementText,SQLINTEGER TextLength );
	参数	StatementHandle	输入参数,设置要准备的语句句柄
		StatementText	输入参数,设置要执行的SQL语句
		TextLength	输入参数,指定*StatementText缓冲区的大小
SQLExecute	函数原型	SQLRETURN SQLExecute(SQLHSTMT StatementHandle);
	参数	StatementHandle	输入参数,设置要执行的语句句柄

SQL诊断函数

SQLGetDiagRec

函数原型


SQLRETURN SQLGetDiagRec(SQLSMALLINT     HandleType,

     SQLHANDLE     Handle,

     SQLSMALLINT     RecNumber,

     SQLCHAR *     Sqlstate,

     SQLINTEGER *     NativeErrorPtr,

     SQLCHAR *     MessageText,

     SQLSMALLINT     BufferLength,

     SQLSMALLINT *     TextLengthPtr
);






















参数


HandleType

输入参数,
指定分配句柄类型

SQL_HANDLE_ENV 分配的是环境句柄
SQL_HANDLE_DBC 分配的是数据库连接句柄
SQL_HANDLE_STMT 分配的是语句句柄



























































Handle


要获得错误信息所处的句柄






















RecNumber


指明需要得到的错误状态行,从1开始逐次增大






















Sqlstate


返回错误状态,错误代码和错误描述






















NativeErrorPtr






















MessageText






















BufferLength


指定MessageText的最大长度






















TextLengthPtr


指定返回的MessageText中有效的字符数





















返回值


SQL_SUCCESS,SQL_SUCCESS_WITH_INFO,SQL_ERROR,SQL_INVALID_HANDLE,SQL_NO_DATA.在没有返回错误的情况下你需要反复调用此函数,并顺次增大RecNumber参数的值,直到函数返回SQL_NO_DATA,以得到所有的错误描述