Skip to content

XGCIBindParamArrayByPos

函数原型

XuguCIRETURN Xugu_API XuguCIBindParamArrayByPos(
    XuguCIHSTMT Hndp,
    int32 Position,
    int32 param_num,
    PARAM_TYPE type,
    int32 array_size,
    void * ValuePtr,
    int32 BuffSize,
    int32 CType,
    int32 * rCodep,
    int32 * ActualLenp,
    int32 SqlType
);

功能

创建程序变量数组和一个SQL语句中的占位符之间的结合。通过位置序号将C变量数组与SQL的变量相联系,是批量数据入库的重要组成部分。

参数

  • Hndp:语句句柄。
  • Position:绑定字段号,从1开始。
  • param_num:总参数个数,本行SQL语句一共的参数位。
  • Type:绑定参数的输入输出型,此处只适合PARAM_IN输入参数。
  • array_size:数组绑定时,数组的长度。内含多少个元素。
  • ValuePtr:绑定的数组参数值指针。
  • BuffSize:参数长度,当参数为字符串指针时,该值表示参数字符串占位符的长度。以字节为单位。
  • CType:该参数在C中的类型。取值1-40。
  • rCodep:字段级返回代码数组的指针。
  • ActualLenp:int型数组,对应参数的实际值的长度,以字节为单位。
  • SqlType:SQL类型,取值1-32具体请参考前面的数据类型映射和xgci.h头文件。

返回值

参考XGCIErrors()函数的返回值表格。