更新日期:2024年09月11日
函数原型:
sword
GCIEnvCreate(
GCIEnv **envhpp,
ub4 mode,
CONST dvoid *ctxp,
CONST dvoid *(*malocfp)(
dvoid *ctxp,
size_t size
),
CONST dvoid *(*ralocfp)(
dvoid *ctxp,
dvoid *memptr,
size_t newsize
),
CONST void (*mfreefp)(
dvoid *ctxp,
dvoid *memptr
),
size_t xtramemsz,
dvoid **usrmempp
);
功能描述:
创建GCI 全局环境,创建并初始化环境句柄,同时在该函数中GCI 将加载相关全局变量
和配置信息,以完成后续的连接步骤。
参数说明:
envhpp(输出)
输出一个生成的环境句柄指针,应用程序可以在环境句柄上分配其他的句柄。
mode(输入)
初始化模式,取值如下:
GCI_DEFAULT:缺省模式
GCI_THREADED:多线程模式
ctxp(输入\输出)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
malocfp(输入)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
ralocfp(输入)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
mfreefp(输入)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
xtramemsz(输入)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
usrmempp(输出)
保留参数,目前不使用(仅用于和Oracle 保持兼容)
返回值:
如果执行成功,返回GCI_SUCCESS,否则返回GCI_ERROR。
注释:
当调用该函数初始化一个环境句柄以后,必须在程序的最后调用GCIHandleFree 来释放
这个句柄。同时,当环境句柄分配以后,目前只允许在上面分配一个上下文句柄,并只允许
建立一个连接,但连接建立之后允许分配多个语句句柄。