OCI指南—OCIStmtExecute()函数

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 语句。调用这个函数时，应用程序与服务器建立请求。