OCIDefineByPos

功能描述

这个函数定义一个将要从服务器中获取数据的输出缓冲区。本函数会为所选字段隐式地分配定义句柄。

原型

sword OCIDefineByPos ( OCIStmt     *stmtp, 
                       OCIDefine  **defnpp,
                       OCIError    *errhp,
                       ub4          position,
                       void        *valuep,
                       sb4          value_sz,
                       ub2          dty,
                       void        *indp,
                       ub2         *rlenp,
                       ub2         *rcodep,
                       ub4          mode );

参数

表 1 OCIDefineByPos参数

参数	参数说明
stmtp	stmt句柄。
defnpp	指向define句柄指针的指针。这个句柄用来保存某个字段的定义信息。
errhp	错误句柄，当有错误发生时，我们可以将该错误句柄传递至 OCIErrorGet()函数获取诊断信息。
position	这个值在所选字段中的位置。位置是从 1 开始的，并且从左向右递增。
valuep	指向 dty 参数所指明的类型的缓冲区或者缓冲区数组的指针。对于 LOB 字段，缓冲区指针必须是OCILobLocator 类型的 LOB 定位符的指针。
value_sz	valuep 指针所指向的缓冲区的大小。
dty	数据类型。
indp	指示器变量或者数组的指针。该指针为指向 sb2 类型的的指针或者是一个 sb2 类型的数组。
rlenp	指向获取到的数据的长度的数组的指针。Rlenp 中的每个元素都是数据的长度。
rcodep	字段级返回代码数组的指针。
mode	只支持OCI_DEFAULT

返回值

OCI_SUCCESS：成功
OCI_ERROR：失败
OCI_INVALID_HANDLE：无效句柄

注意事项

无。