OCIStmtExecute()函数
1. 作用:连接一个应用程序请求值服务器。
2. 函数原型:
sword OCIStmtExecute(
OCISvcCtx *svchp,
OCIStmt *stmtp,
OCIError *errhp,
ub4 iters,
ub4 rowoff,
CONST CISnapshot *snap_in,
OCISnapshot *snap_out,
ub4 mode
);
3.参数
svchp:服务上下文句柄。
stmtp:语句句柄。它定义了语句并且连接数据到服务器。
errhp: 错误句柄,当有错误发生时,我们可以将该错误句柄传递至 OCIErrorGet()函数获取诊断信息。
iters:对于非 SELECT 语句,语句执行的次数等于 iters-rowoff。
对于 SELECT 语句,如果 iters 为非 0,则必须已经完成了语句句柄的定义操作。语句的执行将获取 iters 行数据进入预定义的缓冲区中并且根据预获取行数 prefetch row count 预获取更多行。如果我们不知道 SELECT 语句会返回多少行,则把 iters 设置为 0。
对于非 SELECT 语句,如果 iters=0,则函数返回一个错误。
rowoff:起始索引。关于多行执行的数组绑定中的起始索引。
snap_in:该参数为可选参数。如果使用该参数,其必须指向一个 OCI_DTYPE_SNAP 类型的快照描述符。
snap_out:该参数为可选参数。如果使用该参数,其必须指向 OCI_DTYPE_SNAP 类型的描述符。
mode:模式包括
·OCI_BATCH_ERRORS
·OCI_COMMIT_ON_SUCCESS—当一个语句在此模式下执行时,如果语句成功执行,则执行完成后当前的事务会被提交。
·OCI_DEFAULT—默认模式,使用此模式来调用 OCIStmtExecute()函数。它会隐式地返回关于所选字段的描述信息。
·OCI_DESCRIBE_ONLY—描述模式。这个模式用于在执行前获取查询的描述信息。以此模式调用 OCIStmtExecute()函数并不执行语句,而是返回所选字段的描述信息。为提高性能,建议用户使用默认模式。
·OCI_EXACT_FETCH—
·OCI_PARSE_ONLY—
·OCI_STMT_SCROLLABLE_READONLY--
4. 注释
这个函数用来执行一个已经准备好的 SQL 语句。调用这个函数时,应用程序与服务器建立请求。