Класс CSimpleException

Этот класс является базовым классом для исключений MFC, связанных с критическими ресурсами.

Синтаксис

class AFX_NOVTABLE CSimpleException : public CException

Участники

Открытые конструкторы

Имя	Описание
CSimpleException::CSimpleException	Конструктор.

Открытые методы

Имя	Описание
CSimpleException::GetErrorMessage	Содержит текст об ошибке, которая произошла.

Замечания

CSimpleException — базовый класс для исключений MFC с критически важным ресурсом и обрабатывает владение и инициализацию сообщения об ошибке. Следующие классы используются CSimpleException в качестве базового класса:

Имя	Описание
Класс CMemoryException	Исключение вне памяти
Класс CNotSupportedException	Запросы на неподдерживаемую операцию
Класс CResourceException	Ресурс Windows не найден или не поддерживается
Класс CUserException	Исключение, указывающее, что ресурс не найден
Класс CInvalidArgException	Исключение, указывающее недопустимый аргумент

Так как CSimpleException это абстрактный базовый класс, невозможно объявить объект напрямую CSimpleException . Вместо этого необходимо объявить производные объекты, такие как в предыдущей таблице. Если вы объявляете собственный производный класс, используйте предыдущие классы в качестве модели.

Дополнительные сведения см. в разделе класса CException и обработке исключений (MFC).

Иерархия наследования

CObject

CException

CSimpleException

Требования

Заголовок: afx.h

CSimpleException::CSimpleException

Конструктор.

CSimpleException();
explicit CSimpleException(BOOL bAutoDelete);

Параметры

bAutoDelete
Укажите значение TRUE, если память для CSimpleException объекта была выделена в куче. Это приведет CSimpleException к удалению объекта при Delete вызове функции-члена для удаления исключения. Укажите ЗНАЧЕНИЕ FALSE, если CSimpleException объект находится в стеке или является глобальным объектом. В этом случае CSimpleException объект не будет удален при вызове Delete функции-члена.

Замечания

Обычно никогда не нужно вызывать этот конструктор напрямую. Функция, которая создает исключение, должна создать экземпляр CExceptionпроизводного класса и вызвать его конструктор, или использовать одну из функций создания MFC, таких как AfxThrowFileException, для создания предопределенного типа.

CSimpleException::GetErrorMessage

Вызовите эту функцию-член, чтобы указать текст об ошибке, которая произошла.

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

Параметры

lpszError
Указатель на буфер, который получит сообщение об ошибке.

nMaxError
Максимальное количество символов, которые может содержать буфер, включая терминатор NULL.

pnHelpContext
Адрес UINT, который получит идентификатор контекста справки. Если значение NULL, идентификатор не будет возвращен.

Возвращаемое значение

Ненулевое значение, если функция выполнена успешно; в противном случае значение 0, если текст сообщения об ошибке недоступен.

Замечания

Дополнительные сведения см. в разделе CException::GetErrorMessage.

См. также

Диаграмма иерархии
Класс CException
Обработка исключений