CRecordset::CheckRowsetError
Aufgerufen, um die Fehler zu behandeln generiert während des Rekordabrufens.
Syntax
virtual void CheckRowsetError(
RETCODE nRetCode
);
Parameter
- nRetCode
Ein ODBC API-Funktionsrückgabecode. Details finden Sie Hinweise.
Hinweise
Diese virtuelle Memberfunktion behandelt Fehler, die auftreten, wenn Datensätze abgerufen werden, und während des das gesammelte Abrufen von Zeilen nützlich sind. Sie sollten CheckRowsetError überschreiben, sollten, um eine eigene Fehlerbehandlung zu implementieren.
CheckRowsetError wird automatisch in einem Cursor-Navigationsvorgang, wie Öffnen, Requery oder jedem Move Operation aufgerufen. Es wird der Rückgabewert der ODBC-API-Funktion SQLExtendedFetch übergeben. In der folgenden Tabelle werden die möglichen Werte für den nRetCode-Parameter auf.
nRetCode |
Description |
|---|---|
SQL_SUCCESS |
Funktion erfolgreich abgeschlossen; keine zusätzlichen Informationen verfügbar. |
SQL_SUCCESS_WITH_INFORMATION |
Funktion erfolgreich abgeschlossen, möglicherweise mit einem nichtfatalen Fehler. Zusätzliche Informationen kann abgerufen werden, indem SQLError aufruft. |
SQL_NO_DATA_FOUND |
Alle Zeilen aus dem Resultset abgerufen worden sind. |
SQL_ERROR |
Funktionsfehler. Zusätzliche Informationen kann abgerufen werden, indem SQLError aufruft. |
SQL_INVALID_HANDLE |
Funktion ist aufgrund eines ungültigen Umgebungshandles, -Verbindungshandles oder -Anweisungshandles aus. Dies gibt einen Programmierfehler. Keine zusätzliche Informationen ist von SQLError verfügbar. |
SQL_STILL_EXECUTING |
Eine Funktion, die asynchron gestartet wurde, führt noch aus. Beachten Sie das standardmäßig, MFC nie übergibt diesen Wert auf CheckRowsetError; MFC wird das Aufrufen von SQLExtendedFetch fortgesetzt, bis es nicht mehr SQL_STILL_EXECUTING zurückgibt. |
Weitere Informationen zu SQLError, finden Sie unter Windows SDK. Weitere Informationen über das gesammelte Abrufen von Zeilen, finden Sie im Artikel Recordset: Datensätzen in einer Sammeloperation (ODBC).
Ausnahmen
Exception
Condition
Diese Methode kann Ausnahmen des Typs CDBException* auslösen.
Anforderungen
Header: afxdb.h
Siehe auch
CRecordset Class
Hierarchiediagramm
CRecordset::DoBulkFieldExchange
CRecordset::GetRowsetSize
CRecordset::SetRowsetSize
CRecordset::Move