CSimpleException 类

项目
10/12/2023

此类是资源重要的 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 类
 异常处理

Share via