CDBException::m_strStateNativeOrigin

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

例外の原因を説明する文字列を保持します。

解説

文字列の形式は "State:%s,Native:%ld,Origin:%s" です。それぞれのフォーマットコードは次の値に置き変わります。

SQLSTATE。ODBC 関数 SQLError のパラメータ szSqlState に返される NULL で終わる 5 文字のエラーコードです。SQLSTATE 値の一覧は、「ODBC Programmer's Reference」の付録「ODBC Error Codes」を参照してください。たとえば、"S0022" が返されます。
データソース固有のネイティブなエラーコード。SQLError 関数のパラメータ pfNativeError に返されます。たとえば、207 が返されます。
SQLError 関数のパラメータ szErrorMsg に返されるエラーメッセージ文字列。このメッセージはそれぞれのかっこで囲まれた複数の名前から構成されます。エラーがその発生元からユーザーに渡されるときに、ODBC の各構成要素 (データソース、ドライバ、ドライバマネージャ) の名前が追加されます。この情報はエラーの原因を突き止める手助けとなります。たとえば、[Microsoft] [ODBC SQL Server Driver] [SQL Server] が返されます。

フレームワークはエラー文字列を解釈して、その構成要素を m_strStateNativeOrigin に置きます。m_strStateNativeOrigin に複数のエラーを入れるときは、エラーを改行で区切ります。フレームワークは人間が判読できるエラーテキストを m_strError に置きます。

この文字列の作成に使うコードの追加情報については、「ODBC Programmer's Reference」の SQLError 関数を参照してください。