Compartir a través de

Clase CSimpleException

  • Artículo

Esta clase es una clase base para excepciones MFC de recursos críticos.

Sintaxis

class AFX_NOVTABLE CSimpleException : public CException

Miembros

Constructores públicos

Nombre Descripción
CSimpleException::CSimpleException Constructor .

Métodos públicos

Nombre Descripción
CSimpleException::GetErrorMessage Proporciona texto sobre un error que se ha producido.

Comentarios

CSimpleException es la clase base para las excepciones de MFC críticas para los recursos y controla la propiedad y la inicialización de un mensaje de error. Las siguientes clases usan CSimpleException como clase base:

Nombre Descripción
CMemoryException (clase) Excepción de memoria insuficiente.
CNotSupportedException (clase) Solicitudes de una operación no admitida.
CResourceException (clase) Recurso de Windows no encontrado o que no se puede crear.
CUserException (clase) Excepción que indica que no se ha podido encontrar un recurso.
CInvalidArgException (clase) Excepción que indica un argumento no válido.

Dado que CSimpleException es una clase base abstracta, no se puede declarar un objeto CSimpleException directamente. En su lugar, debe declarar objetos derivados como los de la tabla anterior. Si declara su propia clase derivada, use las clases anteriores como modelo.

Para más información, consulte el tema Clase CException y Control de excepciones (MFC).

Jerarquía de herencia

CObject

CException

CSimpleException

Requisitos

Encabezado: afx.h

CSimpleException::CSimpleException

Constructor .

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Parámetros

bAutoDelete
Especifique TRUE si la memoria del objeto CSimpleException se ha asignado en el montón. Esto hará que el objeto CSimpleException se elimine cuando se llame a la función miembro Delete para eliminar la excepción. Especifique FALSE si el objeto CSimpleException está en la pila o es un objeto global. En este caso, el objeto CSimpleException no se eliminará cuando se llame a la función miembro Delete.

Comentarios

Normalmente, nunca tendría que llamar directamente a este constructor. Una función que produce una excepción debe crear una instancia de una clase derivada de CException y llamar a su constructor, o bien usar una de las funciones throw de MFC, como AfxThrowFileException, para iniciar un tipo predefinido.

CSimpleException::GetErrorMessage

Llame a esta función miembro para proporcionar texto sobre un error que se ha producido.

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

Parámetros

lpszError
Puntero que apunta a un búfer que recibirá un mensaje de error.

nMaxError
Número máximo de caracteres que puede contener el búfer, incluido el terminador NULL.

pnHelpContext
Dirección del elemento UINT que recibirá el identificador de contexto de ayuda. Si es NULL, no se devolverá ningún identificador.

Valor devuelto

Distinto de cero si la función se realiza correctamente; de lo contrario, 0 si no hay texto de mensaje de error disponible.

Comentarios

Para más información, consulte CException::GetErrorMessage.

Consulte también

Gráfico de jerarquías
CException (clase)
Control de excepciones