更新日期:2024年09月11日
功能描述
如果语句中存在参数标记的话,SQLExecute 函数使用参数标记参数的当前值,执行一
条准备好的SQL 语句。
原型
SQLRETURN SQLExecute(SQLHSTMT
StatementHandle);
参数
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
259
表8-23 SQLExecute 参数
关键字
参数说明
StatementHandle
要执行语句的语句句柄。
ColumnNumber
要绑定结果集的列号。起始列号为0,以递增的顺序计算列号,
第0 列是书签列。若未设置书签页,则起始列号为1。
TargetType
缓冲区中C 数据类型的标识符。
TargetValuePtr
输出参数:指向与列绑定的数据缓冲区的指针。SQLFetch 函数
返回这个缓冲区中的数据。如果此参数为一个空指针,则
StrLen_or_IndPtr 是一个有效值。
BufferLength
TargetValuePtr 指向缓冲区的长度,以字节为单位。
StrLen_or_IndPtr
输出参数:缓冲区的长度或指示器指针。若为空值,则未使用
任何长度或指示器值。
返回值
SQL_SUCCESS:表示调用正确。
SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
SQL_ERROR:表示比较严重的错误,如:内存分配失败、建立连接失败等。
SQL_INVALID_HANDLE:表示调用无效句柄。其他API 的返回值同理。
SQL_STILL_EXECUTING:表示语句正在执行。
SQL_NO_DATA:表示SQL 语句不返回结果集。
注意事项
当SQLExecute 函数返回SQL_ERROR 或SQL_SUCCESS_WITH_INFO 时,
可通过调用
SQLGetDiagRec 函数,并将HandleType 和Handle 参数设置为SQL_HANDLE_STMT 和
StatementHandle,可得到一个相关的SQLSTATE 值,通过SQLSTATE 值可以查出调用此函
数的具体信息。
示例
参见8.2.23 示例。
GBase 8c V5 开发者手册
南大通用数据技术股份有限公司
260