Partager via


CRecordset::CheckRowsetError

Appelé pour gérer les erreurs générées pendant la récupération d'enregistrement.

virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Paramètres

  • nRetCode
    Code de retour de fonction API ODBC. Pour plus d'informations, consultez les notes.

Notes

Cette fonction membre virtuelle gère les erreurs qui se produisent lorsque des enregistrements sont récupérés, et sont utiles lors de l'extraction de lignes en bloc. Vous pouvez envisager de substituer CheckRowsetError pour implémenter votre propre gestion des erreurs.

CheckRowsetError est appelé automatiquement dans une opération de navigation de curseur, par exemple Ouvrir, Requery, ou toute opération de Déplacer . Il est passé la valeur de retour de la fonction API ODBC SQLExtendedFetch. Le tableau suivant répertorie les valeurs possibles pour le paramètre d' nRetCode .

nRetCode

Description

SQL_SUCCESS

Fonction terminée avec succès ; aucune informations supplémentaires n'est disponible.

SQL_SUCCESS_WITH_INFORMATION

La fonction est terminée, éventuellement une erreur récupérable. Les informations supplémentaires peuvent être obtenues en appelant SQLError.

SQL_NO_DATA_FOUND

Toutes les lignes du jeu de résultats ont été récupérées.

SQL_ERROR

Échec de la fonction. Les informations supplémentaires peuvent être obtenues en appelant SQLError.

SQL_INVALID_HANDLE

Fonctionnent en raison d'un handle d'environnement, d'un handle de connexion, ou un modèle d'instruction non valide. Cela indique une erreur de programmation. Aucune informations supplémentaires n'est disponible dans SQLError.

SQL_STILL_EXECUTING

Une fonction qui a été démarrée de façon asynchrone exécution. Notez que par défaut, MFC ne passe jamais cette valeur à CheckRowsetError; MFC continue d'appeler SQLExtendedFetch jusqu'à ce qu'il ne retourne plus SQL_STILL_EXECUTING.

Pour plus d'informations sur SQLError, consultez Kit de développement logiciel Windows. Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article recordset : Extraction globale d'enregistrements (ODBC).

Exceptions

Cette méthode peut lever des exceptions de type CDBException*.

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CRecordset, classe

Graphique de la hiérarchie

CRecordset::DoBulkFieldExchange

CRecordset::GetRowsetSize

CRecordset::SetRowsetSize

CRecordset::Move