次の方法で共有

CSimpleException クラス

  • [アーティクル]

このクラスは、リソース クリティカルな MFC 例外の基底クラスです。

構文

class AFX_NOVTABLE CSimpleException : public CException

メンバー

パブリック コンストラクター

名前 説明
CSimpleException::CSimpleException コンストラクター。

パブリック メソッド

名前 説明
CSimpleException::GetErrorMessage 発生したエラーに関するテキストを提供します。

解説

CSimpleException は、リソース クリティカルな MFC 例外の基本クラスであり、エラー メッセージの所有権と初期化を処理します。 次のクラスでは、基底クラスとして CSimpleException を使用します。

名前 説明
CMemoryException クラス メモリ不足の例外
CNotSupportedException クラス サポートされていない操作の要求
CResourceException クラス Windows リソースが見つからないか、作成できない
CUserException クラス リソースが見つからなかったことを示す例外
CInvalidArgException クラス 無効な引数を示す例外

CSimpleExceptionは抽象基底クラスであるため、CSimpleException オブジェクトを直接宣言することはできません。 代わりに、前の表のような派生オブジェクトを宣言する必要があります。 独自の派生クラスを宣言する場合は、前のクラスをモデルとして使用します。

詳細については、「 CException クラス トピックと Exception Handling (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 以外。エラー メッセージ テキストが使用できない場合は 0。

解説

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

関連項目

階層図
CException クラス
例外処理