CRecordset::CheckRowsetError
Nazywane obsługi błędów generowanych podczas pobierania rekordu.
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
Tej metody można zgłosić wyjątków typu CDBException *.
Wymagania
Nagłówek: afxdb.h