Classe CSimpleException

  • Articolo

Questa classe è una classe di base per le eccezioni MFC critiche per le risorse.

Sintassi

class AFX_NOVTABLE CSimpleException : public CException

Membri

Costruttori pubblici

Nome Descrizione
CSimpleException::CSimpleException Costruttore.

Metodi pubblici

Nome Descrizione
CSimpleException::GetErrorMessage Fornisce testo su un errore che si è verificato.

Osservazioni:

CSimpleException è la classe base per le eccezioni MFC critiche per le risorse e gestisce la proprietà e l'inizializzazione di un messaggio di errore. Le classi seguenti usano CSimpleException come classe base:

Nome Descrizione
Classe CMemoryException Eccezione di memoria insufficiente
Classe CNotSupportedException Richieste di un'operazione non supportata
Classe CResourceException Risorsa Di Windows non trovata o non creatabile
Classe CUserException Eccezione che indica che non è stato possibile trovare una risorsa
Classe CInvalidArgException Eccezione che indica un argomento non valido

Poiché CSimpleException è una classe base astratta, non è possibile dichiarare direttamente un CSimpleException oggetto. È invece necessario dichiarare oggetti derivati, ad esempio quelli della tabella precedente. Se si dichiara la propria classe derivata, usare le classi precedenti come modello.

Per altre informazioni, vedere l'argomento Classe CException e Gestione delle eccezioni (MFC).

Gerarchia di ereditarietà

CObject

CException

CSimpleException

Requisiti

Intestazione: afx.h

CSimpleException::CSimpleException

Costruttore.

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parametri

bAutoDelete
Specificare TRUE se la memoria per l'oggetto è stata allocata nell'heap CSimpleException . In questo modo l'oggetto CSimpleException verrà eliminato quando viene chiamata la Delete funzione membro per eliminare l'eccezione. Specificare FALSE se l'oggetto CSimpleException si trova nello stack o è un oggetto globale. In questo caso, l'oggetto CSimpleException non verrà eliminato quando viene chiamata la Delete funzione membro.

Osservazioni:

Normalmente non è mai necessario chiamare direttamente questo costruttore. Una funzione che genera un'eccezione deve creare un'istanza di una classe derivata da e CExceptionchiamare il relativo costruttore oppure deve usare una delle funzioni di generazione MFC, ad esempio AfxThrowFileException, per generare un tipo predefinito.

CSimpleException::GetErrorMessage

Chiamare questa funzione membro per fornire testo su un errore che si è verificato.

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

Parametri

lpszError
Puntatore a un buffer che riceverà un messaggio di errore.

nMaxError
Numero massimo di caratteri che il buffer può contenere, incluso il carattere di terminazione NULL.

pnHelpContext
Indirizzo di un UINT che riceverà l'ID contesto della Guida. Se NULL, non verrà restituito alcun ID.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario, 0 se non è disponibile alcun testo del messaggio di errore.

Osservazioni:

Per altre informazioni, vedere CException::GetErrorMessage.

Vedi anche

Grafico della gerarchia
Classe CException
Gestione delle eccezioni