Коды возврата
Все функции ODBC API возвращают значения, называемые кодами возврата. Код возврата определяет, была ли функция выполнена успешно, или характеризует тип произошедшей ошибки.
В заголовочном файле sql.h определены следующие коды возврата:
| #define SQL_SUCCESS 0 | Функция выполнена успешно |
| #define SQL_SUCCESS_WITH_INFO 1 | Функция выполнена успешно, но с уведомительным сообщением |
| #if (ODBCVER >= 0x0300) #define SQL_NO_DATA 100 #endif | Больше нет строк для извлечения их из результирующего набора. В предыдущей версии ODBC API этот код возврата обозначался как SQL_NO_DATA_FOUND. В версии 3.x код возврата SQL_NO_DATA_FOUND содержатся в заголовочном файле sqlext.h |
| #define SQL_ERROR (-1) | При выполнении функции произошла ошибка |
| #define SQL_INVALID_HANDLE (-2) | Указан неверный дескриптор |
| #define SQL_STILL_EXECUTING 2 | Функция, выполняемая асинхронно, пока не завершена |
| #define SQL_NEED_DATA 99 | Для успешного выполнения данной функции следует предварительно определить необходимые данные |
Первые два кода возврата определяют, что функция была выполнена, а остальные информируют о типе произошедшей ошибки.
Для определения типа кода возврата в заголовочном файле sqltypes.h введено следующее объявление:
typedef signed short RETCODE;
