Freigeben über

CSimpleException-Klasse

  • Artikel

Diese Klasse ist eine Basisklasse für ressourcenkritische MFC-Ausnahmen.

Syntax

class AFX_NOVTABLE CSimpleException : public CException

Member

Öffentliche Konstruktoren

Name Beschreibung
CSimpleException::CSimpleException Der Konstruktor.

Öffentliche Methoden

Name Beschreibung
CSimpleException::GetErrorMessage Stellt Text zu einem Fehler bereit, der aufgetreten ist.

Hinweise

CSimpleException ist die Basisklasse für ressourcenkritische MFC-Ausnahmen und behandelt den Besitz und die Initialisierung einer Fehlermeldung. Die folgenden Klassen werden als Basisklasse verwendet CSimpleException :

Name Beschreibung
CMemoryException-Klasse Ausnahme außerhalb des Arbeitsspeichers
CNotSupportedException-Klasse Anforderungen für einen nicht unterstützten Vorgang
CResourceException-Klasse Windows-Ressource nicht gefunden oder nicht creatierbar
CUserException-Klasse Ausnahme, die angibt, dass eine Ressource nicht gefunden wurde
CInvalidArgException-Klasse Ausnahme, die ein ungültiges Argument angibt

Da CSimpleException es sich um eine abstrakte Basisklasse handelt, können Sie ein CSimpleException Objekt nicht direkt deklarieren. Stattdessen müssen Sie abgeleitete Objekte wie die in der vorherigen Tabelle deklarieren. Wenn Sie Ihre eigene abgeleitete Klasse deklarieren, verwenden Sie die vorherigen Klassen als Modell.

Weitere Informationen finden Sie im Thema zur CException-Klasse und zur Ausnahmebehandlung (Exception Handling, MFC).

Vererbungshierarchie

CObject

CException

CSimpleException

Anforderungen

Header: afx.h

CSimpleException::CSimpleException

Der Konstruktor.

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parameter

bAutoDelete
Geben Sie TRUE an, wenn der Speicher für das CSimpleException Objekt für den Heap zugewiesen wurde. Dadurch wird das CSimpleException Objekt gelöscht, wenn die Delete Memberfunktion aufgerufen wird, um die Ausnahme zu löschen. Geben Sie FALSE an, wenn sich das CSimpleException Objekt im Stapel befindet oder ein globales Objekt ist. In diesem Fall wird das CSimpleException Objekt nicht gelöscht, wenn die Delete Memberfunktion aufgerufen wird.

Hinweise

Normalerweise müssen Sie diesen Konstruktor niemals direkt aufrufen. Eine Funktion, die eine Ausnahme auslöst, sollte eine Instanz einer CExceptionabgeleiteten Klasse erstellen und den Konstruktor aufrufen oder eine der MFC-Auslösenfunktionen verwenden, z . B. AfxThrowFileException, um einen vordefinierten Typ auszuwerfen.

CSimpleException::GetErrorMessage

Rufen Sie diese Memberfunktion auf, um Text zu einem aufgetretenen Fehler bereitzustellen.

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

Parameter

lpszError
Ein Zeiger auf einen Puffer, der eine Fehlermeldung empfängt.

nMaxError
Die maximale Anzahl von Zeichen, die der Puffer enthalten kann, einschließlich des NULL-Terminators.

pnHelpContext
Die Adresse eines UINT, das die Hilfekontext-ID empfängt. Wenn NULL, wird keine ID zurückgegeben.

Rückgabewert

Nonzero, wenn die Funktion erfolgreich ist; andernfalls 0, wenn kein Fehlermeldungstext verfügbar ist.

Hinweise

Weitere Informationen finden Sie unter "CException::GetErrorMessage".

Siehe auch

Hierarchiediagramm
CException-Klasse
Ausnahmebehandlung