CSimpleException, classe

  • Article

Cette classe est une classe de base pour les exceptions MFC critiques pour les ressources.

Syntaxe

class AFX_NOVTABLE CSimpleException : public CException

Membres

Constructeurs publics

Nom Description
CSimpleException ::CSimpleException Constructeur .

Méthodes publiques

Nom Description
CSimpleException ::GetErrorMessage Fournit du texte sur une erreur qui s’est produite.

Notes

CSimpleException est la classe de base pour les exceptions MFC critiques en ressources et gère la propriété et l’initialisation d’un message d’erreur. Les classes suivantes sont utilisées CSimpleException comme classe de base :

Nom Description
CMemoryException, classe Exception hors mémoire
CNotSupportedException, classe Demandes d’une opération non prise en charge
CResourceException, classe Ressource Windows introuvable ou non créatable
CUserException, classe Exception indiquant qu’une ressource est introuvable
CInvalidArgException, classe Exception qui indique un argument non valide

Étant donné qu’il CSimpleException s’agit d’une classe de base abstraite, vous ne pouvez pas déclarer un CSimpleException objet directement. Au lieu de cela, vous devez déclarer des objets dérivés tels que ceux de la table précédente. Si vous déclarez votre propre classe dérivée, utilisez les classes précédentes comme modèle.

Pour plus d’informations, consultez la rubrique classe CException et la gestion des exceptions (MFC).

Hiérarchie d'héritage

CObject

CException

CSimpleException

Spécifications

En-tête : afx.h

CSimpleException ::CSimpleException

Constructeur .

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Paramètres

bAutoDelete
Spécifiez TRUE si la mémoire de l’objet CSimpleException a été allouée sur le tas. Cela entraîne la suppression de l’objet CSimpleException lorsque la Delete fonction membre est appelée pour supprimer l’exception. Spécifiez FALSE si l’objet CSimpleException se trouve sur la pile ou s’il s’agit d’un objet global. Dans ce cas, l’objet CSimpleException ne sera pas supprimé lorsque la Delete fonction membre est appelée.

Notes

Normalement, vous n’avez jamais besoin d’appeler ce constructeur directement. Une fonction qui lève une exception doit créer une instance d’une CExceptionclasse dérivée et appeler son constructeur, ou elle doit utiliser l’une des fonctions de levée MFC, telles qu’AfxThrowFileException, pour lever un type prédéfini.

CSimpleException ::GetErrorMessage

Appelez cette fonction membre pour fournir du texte sur une erreur qui s’est produite.

virtual BOOL GetErrorMessage(
    LPTSTR lpszError,
    UINT  nMaxError,
    PUNIT  pnHelpContext = NULL);

Paramètres

lpszError
Pointeur vers une mémoire tampon qui recevra un message d’erreur.

nMaxError
Nombre maximal de caractères que la mémoire tampon peut contenir, y compris le terminateur NULL.

pnHelpContext
Adresse d’un UINT qui recevra l’ID de contexte d’aide. Si la valeur est NULL, aucun ID n’est retourné.

Valeur de retour

Différent de zéro si la fonction réussit ; sinon, 0 si aucun texte de message d’erreur n’est disponible.

Notes

Pour plus d’informations, consultez CException ::GetErrorMessage.

Voir aussi

Graphique hiérarchique
CException, classe
Gestion des exceptions