virtuel CheckRowsetError void (RETCODE nRetCode );
jeter (CDBException) ;
Paramètres
nRetCode
Code de retour une fonction API ODBC. Pour plus d'informations, voir remarques.
Remarques
Cette fonction membre virtuelle gère les erreurs qui se produisent lorsque les enregistrements sont récupérés, et est utile pendant l'extraction de lignes en bloc. Vous voudrez peut-être envisager de substituer CheckRowsetError afin de mettre en place votre propre gestion des erreurs.
CheckRowsetError est appelée automatiquement lors d'une opération de navigation de curseur, tels que Open, actualiserou toute opération de déplacement . 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 nRetCode.
| nRetCode | Description |
| SQL_SUCCESS | Fonction terminée avec succès ; aucune information supplémentaire n'est disponible. |
| SQL_SUCCESS_WITH_INFO | Fonction terminée avec succès, peut-être avec une erreur non fatale. Renseignements supplémentaires peuvent être obtenus en appelant la fonction SQLError. |
| SQL_NO_DATA_FOUND | Toutes les lignes de l'ensemble de résultats ont été récupérés. |
| SQL_ERROR | Fonction a échoué. Renseignements supplémentaires peuvent être obtenus en appelant la fonction SQLError. |
| SQL_INVALID_HANDLE | Fonction a échoué en raison d'un descripteur d'environnement non valide, le handle de connexion ou de descripteur d'instruction. Cela indique une erreur de programmation. Aucune information supplémentaire n'est disponible à SQLError. |
| SQL_STILL_EXECUTING | Une fonction qui a débuté de façon asynchrone est toujours l'exécution. Notez que par défaut, MFC ne va jamais passer cette valeur à CheckRowsetError; MFC continuera d'appeler SQLExtendedFetch jusqu'à ce qu'elle renvoie n'est plus SQL_STILL_EXECUTING. |
Pour plus d'informations sur la fonction SQLError, consultez la référence du programmeur ODBC SDK. Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article jeu d'enregistrements : extraction de dossiers en vrac (ODBC) dans le Guide du programmeur Visual C++.
Aperçu de CRecordset | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CRecordset::DoBulkFieldExchange, CRecordset::GetRowsetSize, CRecordset::SetRowsetSize, CRecordset::Move