CRecordset::CheckRowsetError

Artikel
06/10/2015

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