Freigeben über


CRecordset::CheckRowsetError

Aufgerufen, um die Fehler zu behandeln generiert während des Rekordabrufens.

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

Diese Methode kann Ausnahmen des Typs CDBException* auslösen.

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CRecordset-Klasse

Hierarchien-Diagramm

CRecordset::DoBulkFieldExchange

CRecordset::GetRowsetSize

CRecordset::SetRowsetSize

CRecordset::Move