ACIStmtGetPieceInfo()

ACIStmtGetPieceInfo()

作用：

返回分段信息以进行分段操作。

语法：

sword ACIStmtGetPieceInfo( const ACIStmt  *stmtp,
                           ACIError       *errhp,
                           void          **hndlpp,
                           ub4            *typep,
                           ub1            *in_outp,
                           ub4            *iterp,
                           ub4            *idxp,
                           ub1            *piecep );

参数：

• stmtp (IN)

执行时返回ACI_NEED_DATA的语句。

• errhp (OUT)

当发生错误时，可以将错误句柄传递给 ACIErrorGet 以获取诊断信息。

• hndlpp (OUT)

返回一个指向绑定或定义绑定句柄的指针，或定义其运行时数据是必需的或正在提供的。

• typep (OUT)

hndlpp指向的句柄类型：ACI_HTYPE_BIND（用于绑定句柄）或ACI_HTYPE_DEFINE（用于定义句柄）。

• in_outp (OUT)

如果IN绑定值需要数据，则返回ACI_PARAM_IN。 如果数据可用作OUT绑定变量或定义位置值，则返回ACI_PARAM_OUT。

• iterp (OUT)

返回多行操作的行号。

• idxp (OUT)

PL / SQL数组绑定操作的数组元素的索引。

• piecep (OUT)

返回以下定义的值之一：ACI_ONE_PIECE，ACI_FIRST_PIECE，ACI_NEXT_PIECE或ACI_LAST_PIECE。

说明：

当execute或fetch调用返回ACI_NEED_DATA以获取或返回动态绑定，定义值或片段时， ACIStmtGetPieceInfo 返回相关信息：绑定或定义句柄，迭代，索引号以及哪个片段。