ODBC对象-Environment

简述

Environment对象，是ODBC的顶层对象，包含了全局的环境参数。

是建立其余数据库对象的先决条件，在使用ODBC访问数据库前，必须首先建立一个Environment对象。

Environment对象建立和释放：

    SQLSMALLINT hEnv = 0;  // Environment对象句柄
    SQLRETURN ret = SQLAllocHandle(SQL_HANDLE_ENV, NULL, &hEnv); // 建立一个Environment句柄
    ret = SQLFreeHandle(SQL_HANDLE_ENV, hEnv);

Environment属性设置和获取：

    Environment使用下列函数获取和设置属性：

SQLRETURN SQLGetEnvAttr(
            SQLENV hEnv, SQLINTEGER attrib, 
            SQLPOINT valueptr, SQLINTEGER buflen, SQLINTEGER *pStrLen);
SQLRETURN SQLSetEnvAttr(
            SQLENV hEnv, SQLINTEGER attrib, 
            SQLPOINT valueptr, SQLINTEGER stringlen);

Environment对象具备的属性：

    SQL_ATTR_CONNECTION_POOLING 

    ODBC-3.8，表示是否在Env层启用链接池，32位无符号整数，取值以下：

                                 SQL_CP_OFF              不启用链接池，默认值。

                                 SQL_CP_ONE_PER_DRIVER   对于每一个ODBC驱动启用一个链接池

                                 SQL_CP_ONE_PER_HENV     对于每一个Env对象启用一个链接池

                                 SQL_CP_DRIVER_AWARE     若是驱动不支持驱动级链接池，则转为启用ENV级链接池。

    SQL_ATTR_CP_MATCH    

    ODBC-3.0，表示SQLConnect和SQLDriverConnect函数执行时，链接获取方式，

                          32位无符号整数，取值以下：

                          SQL_CP_STRICT_MATCH   从链接池中获取全部属性参数都匹配的链接，默认值。

                          SQL_CP_RELAXED_MATCH  获取链接字符串中的关键字匹配的链接，无需全部参数都匹配。

    SQL_ATTR_ODBC_VERSION  

    ODBC-3.0，32位整数，表示当前ODBC接口的行为对应的ODBC版本，

                            在执行任何须要SQLHENV的ODBC函数前，必须先设置该属性，否者将遇到HY010错误。

                            取值以下：

                            SQL_OV_ODBC3_80    ODBC 3.8兼容

                            SQL_OV_ODBC3       ODBC 3.0兼容

                            SQL_OV_ODBC2       ODBC 2.0兼容

    SQL_ATTR_OUTPUT_NTS 

    ODBC 3.0，32位整数，表示驱动返回字符串的方式，取值以下：

                         SQL_TRUE   驱动返回字符串以NULL字符结尾，默认方式。

                         SQL_FALSE  驱动返回字符串不以NULL字符结尾。

                                            该选项值默认不被实现，所以调用SQLSetEnvAttr设置时可能返回错误（HYC00）。