ODBC - API常用函数介绍

ODBC API常用函数诠释 作者: moonbreak, 出处:blog, 责任编辑: 唐小若, 2008-09-03 10:03 ODBC API是一套复杂的函数集，可提供一些通用的接口，以便访问各种后台数据库。本文详细介绍了ODBC API的常用十四个函数并列出在PowerBuilder中外部函数引用声明。 以下为ODBC API的常用十四个函数，先列出在PowerBuilder中外部函数引用声明： nv(ref long phenv) library \

v(long henv) library \

ources(long henv,int fdirection,ref string szdsn,&

er pcbdsn,ref string szdescription,integer cbdescriptionmax,ref integer pcbdescription)library \

onnect(long henv,ref long hdbc)library \

ct (long hstmt,ref string szdsn,integer dsnlen,ref string

ng szpwd,integer pwdlen) library \

nect (long hdbc) library \

mt(long hdbc,ref long hstmt)library \

long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,integ

pelen)library \

ns(long hstmt,ref string sztablequalifier,integer tablequalifierlen,ref string szowner,integer owerlen,ref string szname,in

pelen)library \

ol(long hstmt,integer colnum,integer datatype,ref string name,long maxlen,ref long actlen) library \

ong hstmt)library \

lenv,long hdbc,long hstmt,ref string sqlstate,ref long nativeerror,ref string errormsg,integer errormsgmax,ref integer e

mt(long hstmt,integer Options)library \

1、function integer SQLAllocEnv(ref long phenv) library \ 参数：ref long phenv 引用传递的long类型参数，保存该函数返回的OBDC环境的句柄。 存放在phenv中的值成为以后OBDC API函数调用的唯一标识符。 返回值：integer 成功时，返回0，失败返回值小于0。 函数功能：获取ODBC环境句柄。 2、function integer SQLAllocStmt(long hdbc,ref long hstmt)library \ 参数：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 \ 参数：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 \ 参数：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 \ 参数：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 \ 参数：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 \ 参数：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 \ 参数：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 \ 参数：long lenv ODBC 环境句柄 long hdbc 连接句柄 long hstmt sql语句句柄 ref string sqlstate 用于接受包含sql错误标识的字符串 ref long nativeerror用于接受包含sql错误标识码 ref string errormsg用于接受包含sql错误信息的字符串 integer errormsgmax 函数返回的最多字符数