次の方法で共有

環境の遷移

  • [アーティクル]

ODBC 環境には、次の 3 つの状態があります。

State 説明
E0 未割り当て環境
E1 割り当てられた環境、未割り当て接続
E2 割り当てられた環境、割り当てられた接続

次の表は、各 ODBC 関数が環境の状態にどのように影響するかを示しています。

SQLAllocHandle

E0

未割り当て		 E1

Allocated		 E2

接続
E1[1] --[4] --[4]
(IH)[2] E2[5]
(HY010)[6]		 --[4]
(IH)[3] (IH) --[4]

[1] この行には 、HandleType がSQL_HANDLE_ENVされたときの遷移が表示されます。

[2] この行には 、HandleType がSQL_HANDLE_DBCされたときの遷移が表示されます。

[3] この行には 、HandleType がSQL_HANDLE_STMTまたはSQL_HANDLE_DESCされたときの遷移が表示されます。

[4] 有効なハンドルを指す OutputHandlePtr を使用して SQLAllocHandle を呼び出すと、そのハンドルが上書きされます。 これは、アプリケーション プログラミング エラーである可能性があります。

[5] 環境にSQL_ATTR_ODBC_VERSION環境属性が設定されている。

[6] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されていませんでした。

SQLDataSources と SQLDrivers

E0

未割り当て		 E1

Allocated		 E2

接続
(IH) --[1]
(HY010)[2]		 --[1]
(HY010)[2]

[1] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されている。

[2] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されていませんでした。

SQLEndTran

E0

未割り当て		 E1

Allocated		 E2

接続
(IH)[1] --[3]
(HY010)[4]		 --[3]
(HY010)[4]
(IH)[2] (IH) --

[1] この行には 、HandleType がSQL_HANDLE_ENVされたときの遷移が表示されます。

[2] この行には 、HandleType がSQL_HANDLE_DBCされたときの遷移が表示されます。

[3] 環境でSQL_ATTR_ODBC_VERSION環境属性が設定されていた。

[4] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されていませんでした。

SQLFreeHandle

E0

未割り当て		 E1

Allocated		 E2

接続
(IH)[1] E0 (HY010)
(IH)[2] (IH) --[4]
E1[5]
(IH)[3] (IH) --

[1] この行には 、HandleType がSQL_HANDLE_ENVされたときの遷移が表示されます。

[2] この行には 、HandleType がSQL_HANDLE_DBCされたときの遷移が表示されます。

[3] この行には 、HandleType がSQL_HANDLE_STMTまたはSQL_HANDLE_DESCされたときの遷移が表示されます。

[4] 割り当てられた他の接続ハンドルがありました。

[5] ハンドル で指定された接続ハンドルは、割り当てられた唯一の接続ハンドルでした。

SQLGetDiagField と SQLGetDiagRec

E0

未割り当て		 E1

Allocated		 E2

接続
(IH)[1] -- --
(IH)[2] (IH) --

[1] この行には 、HandleType がSQL_HANDLE_ENVされたときの遷移が表示されます。

[2] この行には 、HandleType がSQL_HANDLE_DBC、SQL_HANDLE_STMT、またはSQL_HANDLE_DESCされたときの遷移が表示されます。

SQLGetEnvAttr

E0

未割り当て		 E1

Allocated		 E2

接続
(IH) --[1]
(HY010)[2]		 --

[1] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されている。

[2] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されていませんでした。

SQLSetEnvAttr

E0

未割り当て		 E1

Allocated		 E2

接続
(IH) --[1]
(HY010)[2]		 (HY011)

[1] SQL_ATTR_ODBC_VERSION環境属性が環境に設定されている。

[2] Attribute 引数がSQL_ATTR_ODBC_VERSIONされず、SQL_ATTR_ODBC_VERSION環境属性が環境に設定されていませんでした。

その他のすべての ODBC 関数

E0

未割り当て		 E1

Allocated		 E2

接続
(IH) (IH) --