Partager via


AfxThrowDBException

Appelez cette fonction pour lever une exception de type CDBException de votre propre code.

void AfxThrowDBException(
   RETCODE nRetCode,
   CDatabase* pdb,
   HSTMT hstmt 
);

Paramètres

  • nRetCode
    Une valeur de type RETCODE, qui définit le type d'erreur qui a provoqué l'exception.

  • pdb
    Un pointeur vers l'objet d' CDatabase qui représente la connexion à la source de données avec laquelle l'exception est associée.

  • hstmt
    Un handle ODBC HSTMT qui spécifie le descripteur d'instruction avec lequel l'exception est associée.

Notes

L'infrastructure appelle AfxThrowDBException lorsqu'elle reçoit ODBC RETCODE d'un appel à une fonction API ODBC et interprète RETCODE comme condition exceptionnelle plutôt qu'une erreur expectable.Par exemple, une opération d'accès aux données peut échouer en raison d'une erreur de lecture de disque.

Pour plus d'informations sur les valeurs de RETCODE définies par ODBC, consultez le chapitre 8, « récupération de l'état et les informations sur l'erreur, » dans Kit de développement logiciel Windows.Pour plus d'informations sur les extensions de MFC à ces codes, consultez la classe CDBException.

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CDBException::m_nRetCode

Concepts

Macro MFC et Globals