SQLGetData
功能描述
返回结果集的一行的一列的一部分或全部。 (长数据值很有用。)
接口原型
RETCODE SQL_API
SQLGetData(HSTMT StatementHandle,
SQLUSMALLINT ColumnNumber,
SQLSMALLINT TargetType,
PTR TargetValue,
SQLLEN BufferLength,
SQLLEN *StrLen_or_Ind)
参数说明
参数名 | 参数说明 |
---|---|
StatementHandle | 语句句柄。 |
ColumnNumber | 对于检索列数据,它是要返回其数据的列数。 结果集列按从1开始增加列顺序进行编号。书签列是列号0;这只能在启用书签时指定。 对于检索参数数据,它是参数的序号,从1开始。 |
TargetType | TargetValue缓冲区的C数据类型标识符。 |
TargetValue | 指向返回数据的缓冲区的指针。 |
BufferLength | TargetValue指向的缓冲区的大小。 |
StrLen_or_Ind | 指向缓冲区的指针,在其中返回长度或指示值。如果这是一个空指针,则不返回长度或指示值。当获取的数据为NULL时,将返回一个错误。 SQLGetData可以在长度/指示符缓冲区中返回以下值:
|
返回
- SQL_SUCCESS:表示调用正确。
- SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
- SQL_INVALID_HANDLE:表示调用无效句柄。其他API的返回值同理
其他
无。