Поделиться через


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

См. также

Ссылки

Класс CRecordset

Диаграмма иерархии

CRecordset::DoBulkFieldExchange

CRecordset::GetRowsetSize

CRecordset::SetRowsetSize

CRecordset::Move