一、初始化OCI程序环境。
OCI8使用OCIInitialize函数来初始化OCI。这是使用OCI8与数据库建立会话必须的一步；同时，必须是第一步。如果成功，则返回0。
函数原型：
sword OCIInitialize (
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 _*/)
)
参数说明：
1．mode——详细说明OCI初始化(Initialize)模式(mode)。它的取值如下：
OCI_DEFAULT——缺省模式；
OCI_THREADED——多线程模式；在该模式下，各并发处理中不为用户所见的内在数据结构受各自线程的保护，而不受别的线程干扰；
OCI_OBJECT——使用目标特性；
OCI_SHARED——使用共享内存；
OCI_EVENTS——
Mode参数可以拥有多个值，以“|”符号分隔各取值项。
2．*Ctxp——用户定义的内存回调程序；默认为0
3．*(*malocfp)——用户定义的内存分配程序；默认为0
4．*(*ralocfp)——重新分配内存程序；默认为0
*memptr 是指向内存块的指针；
5．*mfreefp——用户定义的内存释放程序；默认为0
该函数使用举例如下：
OCIInitialize((ub4) OCI_THREADED | OCI_OBJECT,
(dvoid *)0,(dvoid *(*)(dvoid *, size_t)) 0,
(dvoid * (*)(dvoid *,dvoid *,size_t))0,
(void (*)(dvoid *,dvoid *)) 0 )
注意！OCIEnvCreate() 可以代替OCIInitialize() 和OCIEnvInit()
二、 初始化OCI环境句柄。
在初始化OCI程序环境以后，使用OCIEnvInit来初始化OCI的环境句柄，该函数成功返回0。
函数原型：sword OCIEnvInit(OCIEnv **envhpp,
ub4 mode,
size_t xtramemsz,
dvoid **usrmempp )
参数说明：
1．**envhpp——指向环境句柄的指针；
2．mode——指定初始化环境句柄的模式，其取值如下：
OCI_DEFAULT——缺省模式；在缺省模式下，OCI库始终互斥各环境句柄；
OCI_NO_MUTEX——非互斥模式；在该模式下，OCI库各环境句柄并不互斥，所有
的掉用都使用同一个环境句柄，并且只能有一个环境句柄起作用。
OCI_ENV_NO_UCB——禁止回滚模式；该模式用以禁止在环境句柄初始化过程中的 动态CALL_BACK函数掉用；
3．Xtramemsz——指定在该环境句柄生存期内分配内存的数量；
4．**usrmempp——指向Xtramemsz参数的指针；usermempp参数是函数返回值；
该函数使用举例如下：
应用例子：OCIEnvInit((OCIEnv **) envhp,
(ub4) OCI_DEFAULT,
(size_t) 0,(dvoid **) 0)
三、 分配各OCI句柄。
一个OCI连接在建立前，还需要将所需要的句柄一一分配成功，在OCI8里，使用函数OCIH
andleAlloc来分配各句柄，成功返回0。
函数原型：sword OCIHandleAlloc(CONST dvoid *parenth,
dvoid **hndlpp,
ub4 type,
size_t xtramem_sz,
dvoid **usrmempp )
参数说明：
*parenth——已初始化后的环境句柄；
**hndlpp——函数执行成功后，返回的一个OCI句柄；该返回值的具体含义由type参数来决定；
type——参数hndlpp的返回值的类型；其常用取值如下：
OCI_HTYPE_SVCCTX——返回一个服务类型的句柄；
OCI_HTYPE_ERROR——返回一个错误类型的句柄；
OCI_HTYPE_SESSION——返回一个会话类型的句柄；
OCI_HTYPE_SERVER——返回一个服务器类型的句柄；
OCI_HTYPE_STMT——返回一个陈述类型的句柄；
其中，陈述类型的句柄是在创建与数据库会话成功后，将要对数据库进行操作时分配的，其余类型的句柄是在环境句柄初始化后分配的；
xtramem_sz——指定在该句柄生存期内分配内存的数量；
**usrmempp——指向xtramem_sz参数的指针，由函数返回；
该函数使用举例如下：OCIHandleAlloc((dvoid *) *envhp,
(dvoid **) errhp,
(ub4) OCI_HTYPE_ERROR,
(size_t) 0,
(dvoid **) 0)
四、 为OCI操作数据源创建存储路径（以给定的方式设置服务器连接指针的参数）。
分配各OCI句柄后，还需要做的工作是为OCI操作数据源创建存储路径，并将各项参数设置到相应的句柄中，这项工作由函数OCIServerAttach和OCIAttrSet来实现。成功，返回0。
函数原型：sword OCIServerAttach(OCIServer *srvhp,
OCIError *errhp,
CONST text *dblink,
sb4 dblink_len,
ub4 mode )
常见mpp数据库参数说明：
*srvhp——已分配成功的服务器句柄；
*errhp——已分配成功的错误类型句柄；若该函数执行出错，则该参数承载出错的原因；
*dblink——登陆数据库的实例名；
dblink_len——参数*dblink字符串的长度；
mode——指定不同操作的模式。现在只有一种模式可选：OCI_DEFAULT。
该函数使用举例如下：OCIServerAttach(srvhp, errhp,
(text *) cstring,
(sb4) strlen((char *)cstring),
(ub4) OCI_DEFAULT)
)
函数原型：sword OCIAttrSet (CONST dvoid *trgthndlp,
ub4 trghndltyp,
dvoid *attributep,
ub4 *sizep,
ub4 attrtype,
OCIError *errhp )
参数说明：
*trgthndlp——需要设置的句柄，该句柄在这之前已分配成功；该参数由trghndltyp参数决定；
trghndltyp——参数trgthndlp的类型，其取值参见OCIHandleAlloc函数说明中的type参数说
明；
*attributep——设置参数trgthndlp的值；
*sizep——attributep参数指向的字符串长度；
attrtype——参数attributep的类型；其取值如下：
OCI_ATTR_SERVER——服务器类型；
OCI_ATTR_USERNAME——用户名类型
OCI_ATTR_PASSWORD——用户密码类型
OCI_ATTR_SESSION——会话类型；
*errhp——已分配成功的错误类型句柄；若该函数执行出错，则该参数承载出错的原因；
该函数使用举例如下：OCIAttrSet((dvoid *) svchp,
(ub4) OCI_HTYPE_SVCCTX,
(dvoid *) srvhp,
(ub4) 0,
(ub4) OCI_ATTR_SERVER,
errhp))
（注：此时该函数的意思是将服务器句柄设置到服务句柄中，其类型为服务器类型）
说明：在登陆数据库前以给定的方式设置服务器连接指针的参数时，attrtype参数的所有类型都需要设置到服务句柄中。设置的步骤为：先将服务器句柄设置到服务句柄中，然后将用户名、密码设置到会话句柄中，在调用OCISessionBegin函数成功后，再将会话句柄设置到服务句柄中。
五、 创建并开始与数据库的会话
创建和开始与数据库的会话使用函数OCISessionBegin来实现，其目的是建立与数据库的会话连接；函数成功，返回0。
函数原型：sword OCISessionBegin (OCISvcCtx *svchp,
OCIError *errhp,
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论