功能简介

OCIBindByPos函数用于将程序变量绑定到SQL语句或PL块中的占位符，变量个数应不小于SQL语句或PL块中的占位符个数。若绑定的变量个数超过占位符个数，超过部分将被忽略。

函数声明

sword OCIBindByPos ( OCIStmt       *stmtp, 
                     OCIBind      **bindpp,
                     OCIError      *errhp,
                     ub4            position,
                     void          *valuep,
                     sb4            value_sz,
                     ub2            dty,
                     void          *indp,
                     ub2           *alenp,
                     ub2           *rcodep,
                     ub4            maxarr_len,
                     ub4           *curelep, 
                     ub4            mode );

参数说明

参数名	说明
stmtp (IN/OUT)	正在处理的SQL或PL语句的语句句柄。
bindpp (IN/OUT)	此调用隐式分配的绑定句柄的地址。绑定句柄维护该特定输入值的所有绑定信息。当语句句柄被释放时，该句柄被隐式释放。
errhp (IN/OUT)	一个错误句柄，当出现错误时可以获取诊断信息。
position (IN)	由位置指定的占位符属性。
valuep (IN/OUT)	数据值的地址或dty参数中指定类型的数据值数组。 可以指定一个数据值数组，用于映射到PL表或为SQL多行操作提供数据。对于LOB，必须是指向OCILobLocator类型的LOB定位器的指针。
value_sz (IN)	此绑定变量中任何数据值的可能最大规格，使用valuep传递，单位为字节。 在数组绑定的情况下，该参数为任何元素的可能最大规格，实际规格在alenp参数中指定。
dty (IN)	要绑定的值的数据类型。
indp (IN/OUT)	指向指示器变量或数组的指针。
alenp (IN/OUT)	指向数组元素实际长度的数组的指针。
rcodep (OUT)	指向列级返回代码数组的指针。 动态绑定时，忽略此参数。
maxarr_len (IN)	用户数组可以容纳的元素的最大可能数量。 仅用于PL索引表绑定。
curelep (IN/OUT)	当前数组长度参数，指向执行操作之前或之后数组中实际元素数的指针。 仅用于PL索引表绑定。
mode (IN)	支持的有效模式。

部分参数目前仅支持以下取值：

参数	有效值
dty (IN)	SQLT_INT SQLT_STR SQLT_AFC SQLT_LNG SQLT_FLT SQLT_TIMESTAMP SQLT_INTERVAL_DS SQLT_VNU SQLT_BDOUBLE SQLT_BLOB SQLT_CLOB SQLT_RSET
rcodep	NULL
*bindpp	NULL
maxarr_len	0
curelep	NULL
position	>= 1
mode	OCI_DEFAULT OCI_DATA_AT_EXEC