ODBC API常用函数诠释

记得kony曾经在我的这个坛子上转过一个帖子，解释使用ODBC数据源来连接数据库进行数据库操作速度慢的原因，同时那个帖子也提出了提高ODBC数据源连接数据库进行数据库操作速度的两个办法，一个是利用Visiual Basic中的RDO组件，

一个就是直接调用odbc api函数进行相关数据库操作，应答应过这里的弟弟妹妹们写点关于ODBC API函数方面的东东，所以只能赶鸭子上架了；

以下为ODBC API的常用十四个函数，先列出在PowerBuilder中外部函数引用声明：

function integer SQLAllocEnv(ref long phenv) library "odbc32.dll"

function integer SQLFreeEnv(long henv) library "odbc32.dll"

function integer SQLDataSources(long henv,int fdirection,ref string szdsn,&

integer cbdsnmax,ref integer pcbdsn,ref string szdescription,integer cbdescriptionmax,ref integer pcbdescription)library "odbc32.dll"

function integer SQLAllocConnect(long henv,ref long hdbc)library "odbc32.dll"

function integer SQLConnect (long hstmt,ref string szdsn,integer dsnlen,ref string

szuid,integer uidlen,ref string szpwd,integer pwdlen) library "odbc32.dll"

function integer SQLDisconnect (long hdbc) library "odbc32.dll"

function integer SQLAllocStmt(long hdbc,ref long hstmt)library "odbc32.dll"

function integer SQLTables(long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,integer namelen,

ref string sztype,integer typelen)library "odbc32.dll"

function integer SQLColumns(long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,integer namelen,

ref string sztype,integer typelen)library "odbc32.dll"

function integer SQLBindCol(long hstmt,integer colnum,integer datatype,ref string name,long maxlen,ref long actlen) library "odbc32.dll"

function integer SQLFetch(long hstmt)library "odbc32.dll"

function integer SQLError(long lenv,long hdbc,long hstmt,ref string sqlstate,ref long nativeerror,ref string errormsg,integer errormsgmax,ref integer errormsglen)library "odbc32.dll"

function integer SQLFreeStmt(long hstmt,integer Options)library "odbc32.dll"

1、function integer SQLAllocEnv(ref long phenv) library "odbc32.dll"

参数：ref long phenv 引用传递的long类型参数，保存该函数返回的OBDC环境的句柄。

存放在phenv中的值成为以后OBDC API函数调用的唯一标识符。

返回值：integer 成功时，返回0，失败返回值小于0。

函数功能：获取ODBC环境句柄。

2、function integer SQLAllocStmt(long hdbc,ref long hstmt)library "odbc32.dll"

参数：long hdbc ODBC环境的句柄。

Ref long hstmt 保存SQL语句句柄。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：获取SQL语句句柄。

3、function integer SQLConnect (long hstmt,ref string szdsn,integer dsnlen,ref string szuid,integer uidlen,

ref string szpwd,integer pwdlen) library "odbc32.dll"

参数：long hstmt ,调用SQLAllocStmt()函数获取的句柄。

Ref string szdsn,ODBC数据源名。

Integer dsnlen ,ODBC 数据源名的长度。

Ref string szuid ,用户帐号。

Integer uidlen ，用户帐号长度。

Ref string szpwd ，用户口令。

Ref integer pwdlen,用户口令长度。

返回值：integer ,成功时，返回值大于0，失败返回值小于0。

函数功能：连接ODBC数据源，并返回连接句柄。

4、 function integer SQLDisconnect (long hdbc) library "odbc32.dll"

参数：long hdbc 连接句柄。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：断开连接ODBC数据源。

5、 function integer SQLTables(long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,integer namelen,ref string sztype,integer typelen)library "odbc32.dll"

参数：long hstmt SQL语句句柄

ref string sztablequalifier 表的qualifier名。

integer tablequalifierlen 表的qualifier名的长度。

ref string szowner 表的所有者名。

integer owerlen 表的所有者名长度。

ref string szname 表名。

integer namelen 表名长度。

ref string sztype 表的类型名。

integer typelen 表的类型名长度。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：获取表的信息。

6、 function integer SQLColumns(long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,integer namelen, ref string sztype,integer typelen)library "odbc32.dll"

参数：long hstmt SQL语句句柄

ref string sztablequalifier 表的qualifier名。

integer tablequalifierlen 表的qualifier名的长度。

ref string szowner 表的所有者名。

integer owerlen 表的所有者名长度。

ref string szname 表名。

integer namelen 表名长度。

ref string sztype 表的类型名。

integer typelen 表的类型名长度。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：获取指定表的列信息。

7、Function integer SQLBindCol(long hstmt,integer colnum,integer datatype,ref string name,long maxlen,

ref long actlen) library "odbc32.dll"

参数：long hstmt SQL语句句柄

integer colnum 1-5（是否有资格，拥有者名字、类型、注释）。

integer datatype 1-8，12，99。

ref string name 程序字符串变量。

long maxlen 可变。

ref long actlen 可变。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：绑定结果集。

8、function integer SQLFetch(long hstmt)library "odbc32.dll"

参数：long hstmt SQL语句句柄

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：绑定结果集。

9、function integer SQLError(long lenv,long hdbc,long hstmt,ref string sqlstate,ref long nativeerror,ref string errormsg,integer errormsgmax,ref integer errormsglen)library "odbc32.dll"

参数：long lenv ODBC 环境句柄

long hdbc 连接句柄

long hstmt sql语句句柄

ref string sqlstate 用于接受包含sql错误标识的字符串

ref long nativeerror用于接受包含sql错误标识码

ref string errormsg用于接受包含sql错误信息的字符串

integer errormsgmax 函数返回的最多字符数

ref integer errormsglen函数返回的实际字符数

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：返回调用ODBC API函数错误。

10、function integer SQLFreeEnv(long henv) library "odbc32.dll"

参数：long lenv ODBC 环境句柄

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：释放ODBC环境句柄。

11、function integer SQLFreeStmt(long hstmt,integer Options)library "odbc32.dll"

参数：long hstmt SQL语句句柄。

integer Options 相关选项。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：释放SQL语句句柄。

12、function integer SQLDataSources(long henv,int fdirection,ref string szdsn, integer cbdsnmax,ref integer pcbdsn,ref string szdescription,integer cbdescriptionmax,ref integer pcbdescription)library "odbc32.dll"

参数：long henv ODBC数据源环境句柄。

int fdirection 方向标志 1（下一个），2（第一个），3（最后一个），4（前一个）

ref string szdsn 数据源名称

integer cbdsnmax数据源名称的最大长度

ref integer pcbdsn数据源名称的实际长度

ref string szdescription 数据源描述名称

integer cbdescriptionmax 数据源描述字符串的最大长度

ref integer pcbdescription数据源描述字符串的实际长度

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：释放SQL语句句柄。

13、function integer SQLAllocConnect(long henv,ref long hdbc)library "odbc32.dll"

参数：long henv ODBC数据源环境句柄。

ref long hdbc 保存ODBC连接句柄。

返回值：integer ,成功时，返回0，失败返回值小于0。

函数功能：获取ODBC连接句柄。

-：）上面总算将列出的几个ODBC API函数描述完，等有时间结合具体例子来说明如何利用ODBC API函数访问数据库了-：）

例程：

定义实例变量：

protected:

long henv//sql 环境句柄

long hstmt//sql语句句柄

long hdbc//sql 连接句柄

定义句柄外部函数引用：