函数原型:
sword
GCIEnvInit(
GCIEnv **envp,
ub4 mode,
size_t xtramem_sz,
dvoid **usrmempp
)
;
功能描述:
分配并初始化GCI 环境句柄,此函数必须在GCIInitialize 之后调用
参数说明:
envp(输出)
输出一个生成的环境句柄指针,应用可以在环境句柄上分配其他类型的句柄。
mode(输入)
初始化模式,取值如下:
GCI_DEFAULT:缺省模式
GCI_THREADED:多线程模式
xtramem_sz(输入)
用户自定义分配内存的大小,目前不使用(仅用于和Oracle 保持兼容)
usrmempp(输出)
指向用户自定义分配内存的指针,目前不使用(仅用于和Oracle 保持兼容)
返回值:
如果执行成功,则 返回GCI_SUCCESS,否则返回GCI_ERROR
注释:
当调用该函数初始化一个环境句柄以后,必需调用GCIHandlFree 来释放这个句柄。需
要注意的是,
在环境句柄分配以后,
只允许在上面分配一个上下文句柄,
并只允许建立一个
连接,但是在连接建立后,允许分配多个语句句柄。