Основы проектирования приложений баз данных


         

Коды возврата


Все функции 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;

  1)

  X/Open - консорциум, разрабатывающий стандарты для Unix, CAE (Common Application Environment) - общая прикладная среда.

  2)

  ISO - национальная организация стандартов.

© 2003-2007 INTUIT.ru. Все права защищены.



Содержание  Назад  Вперед