SQLBindCol
功能描述
为结果列分配存储并指定数据类型。SQLBindCol 将应用程序数据缓冲区绑定到结果集中的列。
接口原型
RETCODE SQL_API
SQLBindCol(HSTMT StatementHandle,
SQLUSMALLINT ColumnNumber,
SQLSMALLINT TargetType,
PTR TargetValue,
SQLLEN BufferLength,
参数说明
| 参数名 | 参数说明 |
|---|---|
| StatementHandle | 语句句柄。 |
| ColumnNumber | 要绑定的结果集列的编号。 列按递增的列顺序编号，从0开始，其中列0是书签列。 如果未使用书签（即，SQL_ATTR_USE_BOOKMARKS 语句特性设置为 SQL_UB_OFF，则列号从1开始。 |
| TargetType | TargetValue缓冲区的C数据类型的标识符。当使用SQLFetch、SQLFetchScroll、SQLBulkOperations或SQLSetPos从数据源中获取数据时，驱动程序将数据转换为该类型;当它通过SQLBulkOperations或SQLSetPos向数据源发送数据时，驱动程序将数据从该类型转换过来。 |
| TargetValue | 要与列绑定的缓冲区。 |
| BufferLength | TargetValue指向的缓冲区的大小。 |
| StrLen_or_Ind | 指向要绑定到列的长度/指示器缓冲区的指针。SQLFetch和SQLFetchScroll返回该缓冲区中的值。当Operation为SQL_ADD、SQL_UPDATE_BY_BOOKMARK或SQL_DELETE_BY_BOOKMARK时，SQLBulkOperations从该缓冲区中获取一个值。当Operation为SQL_FETCH_BY_BOOKMARK时，SQLBulkOperations返回该缓冲区中的一个值。当操作为SQL_REFRESH时，SQLSetPos返回该缓冲区中的一个值；当Operation为SQL_UPDATE时，它从这个缓冲区中获取一个值。 |
返回
- SQL_SUCCESS：表示调用正确。
- SQL_ERROR：表示比较严重的错误，如：内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE：表示调用无效句柄。其他API的返回值同理。
其他
无。
