gbase数据、南大通用产品文档：GBase8cSQLSetEnvAttr

功能描述
设置控制环境各方面的属性。
原型
SQLRETURN SQLSetEnvAttr(SQLHENV
EnvironmentHandle,
SQLINTEGER Attribute,
SQLPOINTER ValuePtr, SQLINTEGER StringLength);

GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
268
参数
表8-31 SQLSetEnvAttr 参数
关键字
参数说明
EnvironmentHan dle
环境句柄。
Attribute
需设置的环境属性，可为如下值：

SQL_ATTR_ODBC_VERSION：指定ODBC 版本。

SQL_CONNECTION_POOLING：连接池属性。

SQL_OUTPUT_NTS：指明驱动器返回字符串的形式。
ValuePtr
指向对应Attribute 的值。依赖于Attribute 的值，ValuePtr 可能
是32 位整型值，或为以空结束的字符串。
StringLength
如果ValuePtr 指向字符串或二进制缓冲区，这个参数是
*ValuePtr 长度，如果ValuePtr 指向整型，忽略StringLength。
返回值

SQL_SUCCESS：表示调用正确。

SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。

SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。

SQL_INVALID_HANDLE：表示调用无效句柄。其他API 的返回值同理。
注意事项
当SQLSetEnvAttr 的返回值为SQL_ERROR 或SQL_SUCCESS_WITH_INFO 时，通过
借助SQL_HANDLE_ENV 的HandleType 和EnvironmentHandle 的Handle ，调用
SQLGetDiagRec 可得到相关的SQLSTATE 值，通过SQLSTATE 值可以查出调用此函数的具
体信息。
示例
参见8.2.23 示例。

或（OR）运算符‘|’
操作符含义
所查询内容至少有一个被包含。
示例
例如：'hello | world'，表示查询包含hello 或者world 单词的内容。

点2：192.168.0.3 节点3：192.168.0.4。

连接串中设置server、iplist 和GClusterID 参数。
String _ConnString =
“server=192.168.0.2;failover=true;iplist=192.168.0.3;192.168.0.
4;gclusterid=g1” ;

接口会将18 个连接请求分摊在节点1、节点2 和节点3 上，分摊后每
个节点上会有6 个请求线程。
注：当某个连接请求访问集群节点1 时，接口发现节点1 故障后，在后续
的连接请求到来时接口将不再给节点1 分配请求，
而会将请求分配给节点2
（若
节点2 故障时会分配给节点3）
。
下面例子介绍如何开启集群负载均衡。例子中会创建18 个连接对象，使用