Udostępnij za pośrednictwem

CRecordset::CheckRowsetError

  • Artykuł

 

Nazywane obsługi błędów generowanych podczas pobierania rekordu.

Składnia

      virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Parametry

  • nRetCode
    Funkcja ODBC API zwraca kod.Aby uzyskać szczegółowe informacje Zobacz uwagi.

Uwagi

Ta funkcja Członkowskie wirtualny obsługuje błędy występujące, gdy rekordy są pobierane, i jest przydatne podczas pobierania wierszy luzem.Warto rozważyć przesłanianie CheckRowsetError do realizacji własnych obsługi błędów.

CheckRowsetErrorjest wywoływana automatycznie w operacji kursora nawigacji, takich jak Otwórz, Requery, lub przenieść operacji.Wartość zwracana funkcji interfejsu API ODBC jest przekazywany SQLExtendedFetch.W poniższej tabeli przedstawiono możliwe wartości dla nRetCode parametru.

nRetCode

Opis

SQL_SUCCESS

Funkcja została ukończona pomyślnie; nie dodatkowe informacje są dostępne.

WARTOŚĆ SQL_SUCCESS_WITH_INFO

Funkcja została pomyślnie ukończona, ewentualnie błąd niekrytyczny.Dodatkowe informacje można uzyskać, wywołując SQLError.

SQL_NO_DATA_FOUND

Mieć zostały pobrane wszystkie wiersze z zestawu wyników.

WARTOŚĆ SQL_ERROR

Działanie funkcji nie powiodło się.Dodatkowe informacje można uzyskać, wywołując SQLError.

SQL_INVALID_HANDLE

Niepowodzenie funkcji środowiska nieprawidłowy uchwyt, dojścia połączenia lub dojścia instrukcji.Wskazuje to na błąd programistyczny.Nie dodatkowe informacje są dostępne z SQLError.

SQL_STILL_EXECUTING

Nadal jest wykonywanie funkcji, która została uruchomiona asynchronicznie.Należy zauważyć, że domyślnie MFC nigdy nie będzie przekazać tę wartość do CheckRowsetError; MFC będzie nadal telefonicznej SQLExtendedFetch , dopóki nie zwraca SQL_STILL_EXECUTING.

Więcej informacji o SQLError, zobacz Windows SDK.Aby uzyskać więcej informacji na temat Pobieranie wiersza luzem, zobacz artykuł rekordów: pobieranie rekordów luzem (ODBC).

Wyjątki

Exception

Condition

Tej metody można zgłosić wyjątków typu CDBException *.

Wymagania

Nagłówek: afxdb.h

Zobacz też

Klasa CRecordset
Diagram hierarchii
CRecordset::DoBulkFieldExchange
CRecordset::GetRowsetSize
CRecordset::SetRowsetSize
CRecordset::Move