版本:latest

SQLSetConnectAttr

功能描述

设置控制连接各方面的属性。

原型

c
SQLRETURN SQLSetConnectAttr(SQLHDBC       ConnectionHandle,
                            SQLINTEGER    Attribute,    
                            SQLPOINTER    ValuePtr,     
                            SQLINTEGER    StringLength);

参数

表 1 SQLSetConnectAttr参数

关键字

参数说明

ConnectionHandle

连接句柄。

Attribute

需设置的连接属性,可为如下值:

  • SQL_ATTR_AUTOCOMMIT:设置是否自动提交,1表示自动提交,0表示不自动提交。
  • SQL_ATTR_QUERY_TIMEOUT:用于设置sql执行的最大等待时间,单位为秒。
  • SQL_ATTR_LOGIN_TIMEOUT:用于设置登录数据库的最大等待时间。
  • SQL_ATTR_CONNECTION_TIMEOUT:用于设置数据库建连的超时时间。

若设置的属性不包含在以上范围内,则驱动程序返回SQL_ERROR。

ValuePtr

指向对应属性Attribute的值。依赖于Attribute的值,ValuePtr是32位无符号整型值或指向以空结束的字符串。

StringLength

如果ValuePtr指向字符串或二进制缓冲区,这个参数是*ValuePtr长度,如果ValuePtr指向整型,忽略StringLength。

返回值

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:表示连接属性设置失败。
  • SQL_INVALID_HANDLE:表示传入的句柄无效。

示例

参见:示例