Klasa CSimpleException

Ta klasa jest klasą bazową dla wyjątków MFC o krytycznym znaczeniu dla zasobów.

Składnia

class AFX_NOVTABLE CSimpleException : public CException

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CSimpleException::CSimpleException	Konstruktor.

Metody publiczne

Nazwa/nazwisko	opis
CSimpleException::GetErrorMessage	Zawiera tekst dotyczący błędu, który wystąpił.

Uwagi

CSimpleException jest klasą bazową dla wyjątków MFC o krytycznym znaczeniu dla zasobów i obsługuje własność i inicjowanie komunikatu o błędzie. Następujące klasy używają CSimpleException jako klasy bazowej:

Nazwa/nazwisko	opis
Klasa CMemoryException	Wyjątek braku pamięci
Klasa CNotSupportedException	Żądania nieobsługiwanej operacji
Klasa CResourceException	Nie można odnaleźć zasobu systemu Windows lub nie można go znaleziono
Klasa CUserException	Wyjątek wskazujący, że nie można odnaleźć zasobu
Klasa CInvalidArgException	Wyjątek wskazujący nieprawidłowy argument

Ponieważ CSimpleException jest abstrakcyjną klasą bazową, nie można zadeklarować CSimpleException obiektu bezpośrednio. Zamiast tego należy zadeklarować obiekty pochodne, takie jak te w poprzedniej tabeli. Jeśli deklarujesz własną klasę pochodną, użyj poprzednich klas jako modelu.

Aby uzyskać więcej informacji, zobacz temat Klasa CException i Obsługa wyjątków (MFC).

Hierarchia dziedziczenia

Obiekt CObject

CException

CSimpleException

Wymagania

Nagłówek: afx.h

CSimpleException::CSimpleException

Konstruktor.

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parametry

bAutoDelete
Określ wartość TRUE, jeśli pamięć dla CSimpleException obiektu została przydzielona na stercie. CSimpleException Spowoduje to usunięcie obiektu po wywołaniu funkcji składowej w Delete celu usunięcia wyjątku. Określ wartość FALSE, jeśli CSimpleException obiekt znajduje się na stosie lub jest obiektem globalnym. W takim przypadku CSimpleException obiekt nie zostanie usunięty po wywołaniu funkcji składowej Delete .

Uwagi

Zwykle nigdy nie trzeba wywoływać tego konstruktora bezpośrednio. Funkcja, która zgłasza wyjątek, powinna utworzyć wystąpienie klasy pochodnej CExceptioni wywołać jego konstruktor lub użyć jednej z funkcji throw MFC, takich jak AfxThrowFileException, w celu wyrzucenia wstępnie zdefiniowanego typu.

CSimpleException::GetErrorMessage

Wywołaj tę funkcję składową, aby podać tekst dotyczący błędu, który wystąpił.

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

Parametry

lpszError
Wskaźnik do buforu, który będzie otrzymywać komunikat o błędzie.

nMaxError
Maksymalna liczba znaków, które może pomieścić bufor, łącznie z terminatorem NULL.

pnHelpContext
Adres UINT, który otrzyma identyfikator kontekstu pomocy. Jeśli wartość NULL, nie zostanie zwrócony żaden identyfikator.

Wartość zwracana

Nonzero, jeśli funkcja zakończyła się pomyślnie; w przeciwnym razie 0, jeśli tekst komunikatu o błędzie nie jest dostępny.

Uwagi

Aby uzyskać więcej informacji, zobacz CException::GetErrorMessage.

Zobacz też

Wykres hierarchii
Klasa CException
Obsługa wyjątków