CRecordset::CheckRowsetError
Вызываемый для обработки ошибок, созданные во время записи выборка.
virtual void CheckRowsetError(
RETCODE nRetCode
);
Параметры
- nRetCode
Код возврата функции API ODBC. Дополнительные сведения см. в разделе "Примечания".
Заметки
Эта функция-член виртуального обработки ошибок, которые возникают при записи получены, а также полезны при выполнении пакетная выборка строки. Можно переопределить CheckRowsetError чтобы реализовать собственную обработку ошибок.
CheckRowsetError вызываются автоматически в операции перемещения курсора, такие как Открыть, Requery или любая операция Переместить. Он передается возвращаемое значение функции API ODBC SQLExtendedFetch. В следующей таблице перечислены возможные значения для параметра nRetCode.
nRetCode |
Описание |
|---|---|
Значение SQL_SUCCESS |
Функция успешно завершена; дополнительные сведения недоступны. |
SQL_SUCCESS_WITH_INFORMATION |
Функция успешно завершена, возможно, с некритичные ошибкой. Дополнительная информация может быть получена путем вызова SQLError. |
SQL_NO_DATA_FOUND |
Все строки из результирующего набора выбраны. |
SQL_ERROR |
Ошибка при выполнении функции. Дополнительная информация может быть получена путем вызова SQLError. |
SQL_INVALID_HANDLE |
Неудачей вылтинное сбой на недопустимый дескриптор среды, функцией дескриптора соединения или маркер выписки. Это указывает на ошибку программирования. Дополнительные сведения не доступна из SQLError. |
SQL_STILL_EXECUTING |
Функция, которая была запуститьа все еще выполняется асинхронно. Обратите внимание, что по умолчанию MFC не передает это значение с CheckRowsetError; MFC продолжит вызывать SQLExtendedFetch до тех пор, пока он больше не вернет SQL_STILL_EXECUTING. |
Дополнительные сведения о SQLError см. в разделе Windows SDK. Дополнительные сведения о массовой строке выборке см. в статье Набор записей. Пакетная выборка строк (ODBC).
Исключения
Этот метод может создавать исключения типа CDBException*.
Требования
Header: afxdb.h