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
如果已在堆上分配 CSimpleException 对象的内存,则指定 TRUE。 这将导致在调用 Delete 成员函数来删除异常时删除 CSimpleException 对象。 如果 CSimpleException 对象在堆栈上或者是全局对象,则指定 FALSE。 在这种情况下,调用 Delete 成员函数时不会删除 CSimpleException 对象。

备注

通常不需要直接调用此构造函数。 引发异常的函数应创建 CException 派生类的实例并调用其构造函数,或者应使用 MFC 引发函数之一(例如 AfxThrowFileException)来引发预定义类型。

CSimpleException::GetErrorMessage

调用此成员函数以提供有关已发生的错误的文本。

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

参数

lpszError
指向接收错误消息的缓冲区的指针。

nMaxError
缓冲区可容纳的最大字符数,包括 NULL 终止符。

pnHelpContext
将接收帮助上下文 ID 的 UINT 的地址。 如果为 NULL,则不会返回 ID。

返回值

如果函数成功,则为非零;如果没有错误消息文本可用,则为 0。

备注

有关详细信息,请参阅 CException::GetErrorMessage

另请参阅

层次结构图
CException 类
异常处理