Classe CSimpleException

Essa classe é uma classe base para exceções MFC críticas para o recurso.

Sintaxe

class AFX_NOVTABLE CSimpleException : public CException

Membros

Construtores públicos

Nome	Descrição
CSimpleException::CSimpleException	O construtor .

Métodos públicos

Nome	Descrição
CSimpleException::GetErrorMessage	Fornece texto sobre um erro que ocorreu.

Comentários

CSimpleException é a classe base para exceções de MFC críticas ao recurso e manipula a propriedade e a inicialização de uma mensagem de erro. As seguintes classes usam CSimpleException como classe base:

Nome	Descrição
Classe CMemoryException	Exceção de memória insuficiente
Classe CNotSupportedException	Solicitações para uma operação sem suporte
Classe CResourceException	Recurso do Windows não encontrado ou não criável
Classe CUserException	Exceção que indica que não foi possível encontrar um recurso
Classe CInvalidArgException	Exceção que indica um argumento inválido

Como CSimpleException é uma classe base abstrata, você não pode declarar um objeto CSimpleException diretamente. Em vez disso, você deve declarar objetos derivados, como os da tabela anterior. Se você estiver declarando sua própria classe derivada, use as classes anteriores como modelo.

Para obter mais informações, consulte o tópico sobre a Classe CException e o Tratamento de exceções (MFC).

Hierarquia de herança

CObject

CException

CSimpleException

Requisitos

Cabeçalho: afx.h

CSimpleException::CSimpleException

O construtor .

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parâmetros

bAutoDelete
Especifique TRUE se a memória do objeto CSimpleException tiver sido alocada no heap. Isso fará com que o objeto CSimpleException seja excluído quando a função membro Delete for chamada para excluir a exceção. Especifique FALSE se o objeto CSimpleException estiver na pilha ou for um objeto global. Nesse caso, o objeto CSimpleException não será excluído quando a função membro Delete for chamada.

Comentários

Normalmente, você nunca precisaria chamar esse construtor diretamente. Uma função que gera uma exceção deve criar uma instância de uma classe derivada CException e chamar seu construtor, ou deve usar uma das funções throw do MFC, como AfxThrowFileException, para lançar um tipo predefinido.

CSimpleException::GetErrorMessage

Chame essa função membro para fornecer texto sobre um erro que ocorreu.

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

Parâmetros

lpszError
Ponteiro para um buffer que receberá uma mensagem de erro.

nMaxError
O número máximo de caracteres que o buffer pode conter, incluindo o terminador NULL.

pnHelpContext
O endereço de um UINT que receberá a ID de contexto de ajuda. Se NULL, nenhuma ID será retornada.

Valor de Devolução

Não zero se a função for bem-sucedida; caso contrário, 0 se nenhum texto de mensagem de erro estiver disponível.

Comentários

Para obter mais informações, consulte CException::GetErrorMessage.

Confira também

Gráfico da hierarquia
Classe CException
Tratamento de exceção