CDaoErrorInfo 構造体

CDaoErrorInfo構造体には、データ アクセス オブジェクト (DAO) に対して定義されたエラー オブジェクトに関する情報が含まれています。

Note

DAO は、Office 2013 でサポートされています。 DAO 3.6 は最終バージョンであり、古いと見なされます。

構文

struct CDaoErrorInfo
{
    long m_lErrorCode;
    CString m_strSource;
    CString m_strDescription;
    CString m_strHelpFile;
    long m_lHelpContext;
};

パラメーター

m_lErrorCode
数値 DAO エラー コード。 DAO ヘルプのトピック「トラップ可能なデータ アクセス エラー」を参照してください。

m_strSource
最初にエラーを生成したオブジェクトまたはアプリケーションの名前。 Source プロパティは、最初にエラーを生成したオブジェクトを表す文字列式を指定します。通常、式はオブジェクトのクラス名です。 詳細については、DAO ヘルプの「ソース プロパティ」のトピックを参照してください。

m_strDescription
エラーに関連付けられた説明文字列。 詳細については、DAO ヘルプのトピック「Description プロパティ」を参照してください。

m_strHelpFile
Microsoft Windows ヘルプ ファイルへの完全修飾パス。 詳細については、DAO ヘルプのトピック「HelpContext、HelpFile プロパティ」を参照してください。

m_lHelpContext
Microsoft Windows ヘルプ ファイル内のトピックのコンテキスト ID。 詳細については、DAO ヘルプのトピック「HelpContext、HelpFile プロパティ」を参照してください。

解説

MFC は、DAO エラー オブジェクトをクラスにカプセル化しません。 代わりに、 CDaoException クラスは、DAO DBEngine オブジェクトに含まれる Errors コレクション (すべてのワークスペースも含むオブジェクト) にアクセスするためのインターフェイスを提供します。 MFC DAO 操作がキャッチした CDaoException オブジェクトをスローすると、MFC は CDaoErrorInfo 構造体を埋め、それを例外オブジェクトの m_pErrorInfo メンバーに格納します。 (DAO を直接呼び出す場合は、例外オブジェクトの を呼び出す必要があります。GetErrorInfo メンバー関数を自分で入力 m_pErrorInfo)。

DAO エラーの処理の詳細については、「exceptions: データベースの例外記事を参照してください。 関連情報については、DAO ヘルプの「エラー オブジェクト」を参照してください。

CDaoException::GetErrorInfo メンバー関数によって取得された情報は、CDaoErrorInfo構造体に格納されます。 例外ハンドラーでキャッチしたCDaoExceptionオブジェクトから m_pErrorInfo データメンバーを調べるか、または直接呼び出し中に発生した可能性のあるエラーを確認するために明示的に作成したCDaoExceptionオブジェクトからGetErrorInfoを呼び出します。を DAO インターフェイスにします。 CDaoErrorInfo では、デバッグ ビルドで Dump メンバー関数も定義します。 Dump を使用して、CDaoErrorInfo オブジェクトの内容をダンプすることができます。

要件

ヘッダー: afxdao.h

関連項目

構造体、スタイル、コールバック関数とメッセージ マップ
CDaoException クラス