返回值类型¶
接口调用时,开发者需要根据返回值来判定执行情况,因此需要参考返回值的意义:
| 宏定义 | 值 | 意义 |
|---|---|---|
| SQL_SUCCESS | 0 | 接口成功执行 |
| SQL_SUCCESS_WITH_INFO | 1 | 接口成功执行,但有警告,可从错误信息中获得相关警告信息, 一般在获取数据时有数据被截断的场景会返回该值。 |
| SQL_ERROR | -1 | 接口执行错误,可从错误信息中获得具体错误信息。 |
| SQL_INVALID_HANDLE | -2 | 无效的句柄,一般是具体没有申请成功,但后续将这个句柄传入到其他接口中 使用时会报这个错误,因此遇到这个返回值时,请检查使用的句柄是否正确。 |
| SQL_NO_DATA | 100 | 如果执行的update、delete语句没有影响行数时,则可能返回该值。 不过由于驱动执行的ODBC标准不同,这种情况也可能返回SQL_SUCCESS。 |
| SQL_NEED_DATA | 99 | SQL中有参数,但在执行时没有 绑定参数,则可能会返回这个值,还有其他情况也可能会返回这个值。 |
| SQL_STILL_EXECUTING | 2 | 表示当前语句句柄正在执行SQL语句, |