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