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。在此情況下， CSimpleException 呼叫成員函式時 Delete ，將不會刪除物件。

備註

您通常不需要直接呼叫此建構函式。擲回例外狀況的函式應該建立衍生類別的 CException 實例並呼叫其建構函式，或者應該使用其中一個 MFC throw 函式，例如 AfxThrowFileException 來擲回預先定義的類型。

CSimpleException：：GetErrorMessage

呼叫此成員函式，以提供發生錯誤的相關文字。

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

參數

lpszError
將接收錯誤訊息之緩衝區的指標。

nMaxError
緩衝區可以保存的最大字元數，包括 Null 結束字元。

pnHelpCoNtext
將接收說明內容識別碼的 UINT 位址。如果為 Null，則不會傳回任何識別碼。

傳回值

如果函式成功，則為非零;否則，如果沒有可用的錯誤訊息文字，則為 0。

備註

如需詳細資訊，請參閱 CException：：GetErrorMessage 。

另請參閱

階層架構圖表
 CException 類別
 例外狀況處理

共用方式為