SQLBindParameter

功能描述

将一条SQL语句中的一个参数标志和一个缓冲区绑定起来。

原型

  1. SQLRETURN SQLBindParameter(SQLHSTMT       StatementHandle,    
  2.                            SQLUSMALLINT   ParameterNumber,     
  3.                            SQLSMALLINT    InputOutputType,
  4.                            SQLSMALLINT    ValuetType,
  5.                            SQLSMALLINT    ParameterType,
  6.                            SQLULEN    ColumnSize,
  7.                            SQLSMALLINT    DecimalDigits,
  8.                            SQLPOINTER     ParameterValuePtr,
  9.                            SQLLEN     BufferLength,
  10.                            SQLLEN     *StrLen_or_IndPtr);

参数

表 1 SQLBindParameter

关键词

参数说明

StatementHandle

语句句柄。

ParameterNumber

参数序号，起始为1，依次递增。

InputOutputType

输入输出参数类型。

ValueType

参数的C数据类型。

ParameterType

参数的SQL数据类型。

ColumnSize

列的大小或相应参数标记的表达式。

DecimalDigits

列的十进制数字或相应参数标记的表达式。

ParameterValuePtr

指向存储参数数据缓冲区的指针。

BufferLength

ParameterValuePtr指向缓冲区的长度，以字节为单位。

StrLen_or_IndPtr

缓冲区的长度或指示器指针。若为空值，则未使用任何长度或指示器值。

返回值

  • SQL_SUCCESS：表示调用正确。
  • SQL_SUCCESS_WITH_INFO：表示会有一些警告信息。
  • SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
  • SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。

注意事项

当SQLBindParameter返回SQL_ERROR或SQL_SUCCESS_WITH_INFO时，通过调用SQLGetDiagRec函数，并将HandleType和Handle参数设置为SQL_HANDLE_STMT和StatementHandle，可得到一个相关的SQLSTATE值，通过SQLSTATE值可以查出调用此函数的具体信息。

示例

参见：示例