Partilhar via

Classe CSimpleException

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe é uma classe base para exceções MFC críticas a recursos.

Sintaxe

class AFX_NOVTABLE CSimpleException : public CException

Membros

Construtores Públicos

Nome Description
CSimpleException::CSimpleException O construtor.

Métodos Públicos

Nome Description
CSimpleException::GetErrorMessage Fornece texto sobre um erro que ocorreu.

Observações

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

Nome Description
CMemoryException Classe Exceção por falta de memória
CNotSupportedException Classe Pedidos para uma operação não suportada
CResourceException Classe Recurso do Windows não encontrado ou não criável
CUserException Classe Exceção que indica que um recurso não pôde ser encontrado
Classe CInvalidArgException Exceção que indica um argumento inválido

Como CSimpleException é uma classe base abstrata, não se pode declarar um CSimpleException objeto diretamente. Em vez disso, deve declarar objetos derivados, como os da tabela anterior. Se estiveres a declarar a tua própria classe derivada, usa as classes anteriores como modelo.

Para mais informações, consulte o tópico da Classe CException e Tratamento de Exceções (MFC).

Hierarquia de herança

CObject

CException

CSimpleException

Requerimentos

Cabeçalho: afx.h

CSimpleException::CSimpleException

O construtor.

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parâmetros

bAutoDelete
Especifique TRUE se a memória do CSimpleException objeto foi alocada no heap. Isto fará com que o CSimpleException objeto seja eliminado quando a Delete função membro for chamada para eliminar a exceção. Especifique FALSE se o CSimpleException objeto estiver na pilha ou for um objeto global. Neste caso, o CSimpleException objeto não será eliminado quando a Delete função membro for chamada.

Observações

Normalmente nunca precisarias de chamar diretamente este construtor. Uma função que lança uma exceção deve criar uma instância de uma CExceptionclasse derivada em e chamar o seu construtor, ou deve usar uma das funções de lançamento MFC, como AfxThrowFileException, para lançar um tipo predefinido.

CSimpleException::GetErrorMessage

Chame esta função membro para fornecer texto sobre um erro que tenha ocorrido.

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

Parâmetros

lpszError
Um apontador 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 irá receber o ID de contexto de ajuda. Se NULL, não será devolvida identificação.

Valor de retorno

Não nula se a função for bem-sucedida; caso contrário, 0 se não houver mensagem de erro disponível.

Observações

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

Consulte também

Gráfico de Hierarquia
Aula CException
Tratamento de exceções

  • Last updated on