SQL SetConnectAttr函数定义及用法讲解

程序员文章站 2023-11-15 19:23:04

sqlsetconnectattr 函数定义：用法类似于sqlsetenvattr，该函数是设置连接的各项属性用的 sqlreturnsqlsetconnectattr( sqlhdbcconne...

sqlsetconnectattr

函数定义：

用法类似于sqlsetenvattr，该函数是设置连接的各项属性用的

sqlreturnsqlsetconnectattr(

sqlhdbcconnectionhandle,

sqlintegerattribute,

sqlpointervalueptr,

sqlintegerstringlength);

参数详解：

connectionhandle：输入变量

连接的句柄

attribute：输入变量 valueptr：输入变量

attribute	valueptrcontents
sql_attr_access_mode (odbc 1.0)	sql_mode_read_only 设置为只读连接，update类似的操作都是不能在他下属的stmt中执行的，只能支持查询语句。 sql_mode_read_write默认值，可读可写
sql_attr_async_enable (odbc 3.0)	该连接下属的stmthandle所执行的语句可以异步处理 sql_async_enable_off = off 默认值关闭异步处理 sql_async_enable_on = on开启异步处理
sql_attr_auto_ipd (odbc 3.0)	不好意思说实话没搞懂这个是啥，如果有知道的大佬麻烦留言一下，我加上去帮助到更多的人 a read-only sqluinteger value that specifies whether automatic population of the ipd after a call tosqlprepareis supported: sql_true = automatic population of the ipd after a call tosqlprepareis supported by the driver. sql_false = automatic population of the ipd after a call tosqlprepareis not supported by the driver. servers that do not support prepared statements will not be able to populate the ipd automatically. if sql_true is returned for the sql_attr_auto_ipd connection attribute, the statement attribute sql_attr_enable_auto_ipd can be set to turn automatic population of the ipd on or off. if sql_attr_auto_ipd is sql_false, sql_attr_enable_auto_ipd cannot be set to sql_true. the default value of sql_attr_enable_auto_ipd is equal to the value of sql_attr_auto_ipd. this connection attribute can be returned bysqlgetconnectattrbut cannot be set bysqlsetconnectattr.
sql_attr_autocommit (odbc 1.0)	设置是否自动提交： sql_autocommit_off关闭自动提交，可以手动commit或者rollback sql_autocommit_on 自动提交开启，一但执行会自动commit
sql_attr_connection_dead (odbc 3.5)	终止连接 sql_cd_true关闭连接 sql_cd_false保持连接
sql_attr_connection_timeout (odbc 3.0)	除了查询与登录外的操作超时时长，单位为秒，整型。默认为0秒，意思不是执行sql语句立马超时而是不会超时，一直等待语句完成才向后执行
sql_attr_current_catalog (odbc 2.0)	一个包含database名称的字符串指针。
sql_attr_login_timeout (odbc 1.0)	设置登录超时时长，同sql_attr_connection_timeout
sql_attr_metadata_id (odbc 3.0)	设定连接catalog函数参数 sql_true设置启用标识符id if sql_false设置不启用标识符id
sql_attr_odbc_cursors (odbc 2.0)	设置连接游标参数 sql_cur_use_if_needed 当必要时采用游标 sql_cur_use_odbc 使用obdc游标 sql_cur_use_driver使用驱动游标
sql_attr_packet_size (odbc 2.0)	设置连接包大小，格式为(void*)(整型数字)
sql_attr_quiet_mode (odbc 2.0)	设置对话框，当窗口句柄为空的时候，设置为不显示对话框
sql_attr_trace (odbc 1.0)	设置连接是否启用跟踪 sql_opt_trace_off 默认，不跟踪 sql_opt_trace_on 跟踪会将跟踪记录写入root下的sql.log
sql_attr_tracefile (odbc 1.0)	设置跟踪文件路径，参数为一个null-terminated 字符串。
sql_attr_translate_lib (odbc 1.0)	设置连接转化字符集的动态库路径，参数为一个null-terminated 字符串
sql_attr_translate_option (odbc 1.0)	设置连接转化字符集的参数，详情见translation dlls.
sql_attr_txn_isolation (odbc 1.0)	设置连接事务隔离级别详情见transaction isolation levels.

stringlength：输入变量

如果valueptr为字符串，填入字符串长度或者sql_nts.

如果是二进制缓存填入sql_len_binary_attr(length)的结果if valueptr is a pointer to a不是上述两个填入sql_is_pointer.

如果是边长的数组根据情况填入sql_is_integer或者sql_is_uinteger

返回值：

返回值有四种：sql_success, sql_success_with_info, sql_invalid_handle, or sql_error.

查看详细错误信息可调用sqlgetdiagrec函数（之后章节讲解）。