CRecordset::CheckRowsetError

Статья
04/29/2016

Вызываемый для обработки ошибок, созданные во время записи выборка.

Синтаксис

      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).

Исключения

Exception

Condition

Этот метод может создавать исключения типа CDBException*.

Требования

Header: afxdb.h

См. также

CRecordset Class
Диаграмма иерархии
CRecordset::DoBulkFieldExchange
CRecordset::GetRowsetSize
CRecordset::SetRowsetSize
CRecordset::Move

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