CRecordset::CheckRowsetError

Article
06/10/2015

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