更新日期:2024年09月11日
SQLBindParameter
功能描述
将一条SQL 语句中的一个参数标志和一个缓冲区绑定起来。
原型
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
253
SQLRETURN SQLBindParameter(SQLHSTMT
StatementHandle,
SQLUSMALLINT ParameterNumber,
SQLSMALLINT
InputOutputType,
SQLSMALLINT ValuetType,
SQLSMALLINT ParameterType,
SQLULEN ColumnSize,
SQLSMALLINT DecimalDigits,
SQLPOINTER ParameterValuePtr,
SQLLEN BufferLength,
SQLLEN *StrLen_or_IndPtr);
参数
表8-18 SQLBindParameter 参数
关键字
参数说明
StatementHandle
语句句柄。
ParameterNumbe r
参数序号,起始为1,依次递增。
InputOutputType
输入输出参数类型。
ValueType
参数的C 数据类型。
ParameterType
参数的SQL 数据类型。
ColumnSize
列的大小或相应参数标记的表达式。
DecimalDigits
列的十进制数字或相应参数标记的表达式。
ParameterValuePt r
指向存储参数数据缓冲区的指针。
BufferLength
ParameterValuePtr 指向缓冲区的长度,以字节为单位。
StrLen_or_IndPtr
缓冲区的长度或指示器指针。若为空值,则未使用任何长度或
指示器值。
返回值
SQL_SUCCESS:表示调用正确。
SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
254
SQL_INVALID_HANDLE:表示调用无效句柄。其他API 的返回值同理。
注意事项
当SQLBindParameter 返回SQL_ERROR 或SQL_SUCCESS_WITH_INFO 时,
通过调用
SQLGetDiagRec 函数,并将HandleType 和Handle 参数设置为SQL_HANDLE_STMT 和
StatementHandle,
可得到一个相关的SQLSTATE 值,
通过SQLSTATE 值可以查出调用此函
数的具体信息。
示例
参见8.2.23 示例。