VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

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_NO_TOTAL
  • SQL_NULL_DATA

返回

  • SQL_SUCCESS:表示调用正确。
  • SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
  • SQL_INVALID_HANDLE:表示调用无效句柄。其他API的返回值同理

其他

无。