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)。
繼承階層架構
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。