Share via

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 を指定します。 これにより、例外を CSimpleException 削除するためにメンバー関数が Delete 呼び出されたときにオブジェクトが削除されます。 オブジェクトがスタック上にある場合、またはグローバル オブジェクトであるCSimpleException場合は、FAL Standard Edition を指定します。 この場合、メンバー関数が CSimpleException 呼び出されたときに Delete オブジェクトは削除されません。

解説

通常、このコンストラクターを直接呼び出す必要はありません。 例外をスローする関数は、-derived クラスのCExceptionインスタンスを作成してそのコンストラクターを呼び出すか、MFC スロー関数 (AfxThrowFileException など) のいずれかを使用して定義済みの型をスローする必要があります。

CSimpleException::GetErrorMessage

このメンバー関数を呼び出して、発生したエラーに関するテキストを指定します。

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

パラメーター

lpszError
エラー メッセージを受信するバッファーへのポインター。

nMaxError
バッファーが保持できる最大文字数 (NULL ターミネータを含む)。

pnHelpContext
ヘルプ コンテキスト ID を受け取る UINT のアドレス。 NULL の場合、ID は返されません。

戻り値

関数が成功した場合は 0 以外。エラー メッセージ テキストが使用できない場合は 0。

解説

詳細については、「CException::GetErrorMessage」を参照してください。

関連項目

階層図
CException クラス
例外処理