接続の遷移

ODBC 接続の状態は次のとおりです。

State	説明
C0	未割り当て環境、未割り当て接続
C1	割り当てられた環境、未割り当て接続
C2	割り当てられた環境、割り当てられた接続
C3	接続関数にはデータが必要です
C4	接続済み接続
C5	接続接続、割り当て済みステートメント
C6	接続済み接続、トランザクションの進行中。 接続にステートメントが割り当てられていない状態で、接続が C6 状態になる可能性があります。 たとえば、接続が手動コミット モードで、状態 C4 にあるとします。 ステートメントが割り当てられ、実行され (トランザクションを開始する)、解放された場合、トランザクションはアクティブなままですが、接続にステートメントはありません。

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

SQLAllocHandle

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
C1[1]	--[5]	--[5]	--[5]	--[5]	--[5]	--[5]
(IH)[2]	C2	--[5]	--[5]	--[5]	--[5]	--[5]
(IH)[3]	(IH)	(08003)	(08003)	C5	--[5]	--[5]
(IH)[4]	(IH)	(08003)	(08003)	--[5]	--[5]	--[5]

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

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

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

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

[5] SQLAllocHandle OutputHandlePtr を指す有効なハンドルを呼び出すと、そのハンドルの前の内容に関係なくそのハンドルが上書きされ、ODBC ドライバーに問題が発生する可能性があります。 *OutputHandlePtr に対して定義されているのと同じアプリケーション変数を使用して SQLAllocHandle を 2 回呼び出しSQLFreeHandleを呼び出さずにハンドルを解放するのは、ODBC アプリケーション プログラミングでは正しくありません。 このような方法で ODBC ハンドルを上書きすると、ODBC ドライバーの動作やエラーが一貫性を失う可能性があります。

SQLBrowseConnect

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	C3 [d] C4 [s]	-- [d] C2 [e] C4 [s]	(08002)	(08002)	(08002)

SQLCloseCursor

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--	--[1] C5[2]

[1] 接続は手動コミット モードでした。

[2] 接続は自動コミット モードでした。

SQLColumnPrivileges、SQLColumns、SQLForeignKeys、SQLGetTypeInfo、SQLPrimaryKeys、SQLProcedureColumns、SQLProcedures、SQLSpecialColumns、SQLStatistics、SQLTablePrivileges、および SQLTables

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--

[1] 接続が自動コミット モードであったか、データ ソースがトランザクションを開始しませんでした。

[2] 接続は手動コミット モードで、データ ソースはトランザクションを開始しました。

SQLConnect

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	C4	(08002)	(08002)	(08002)	(08002)

SQLCopyDesc、SQLGetDescField、SQLGetDescRec、SQLSetDescField、SQLSetDescRec

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	--[1]	--	--

[1] この状態では、アプリケーションで使用できる記述子は明示的に割り当てられた記述子のみです。

SQLDataSources と SQLDrivers

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	--	--	--	--	--	--

SQLDisconnect

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(08003)	C2	C2	C2	25000

SQLDriverConnect

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	C4 s -- n[f]	(08002)	(08002)	(08002)	(08002)

SQLEndTran

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)[1]	--[3]	--[3]	--[3]	--	--	--[4] または ([5]、[6]、および [8]) C4[5] および [7] C5[5]、[6]、および [9]
(IH)[2]	(IH)	(08003)	(08003)	--	--	C5

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

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

[3] 接続は接続状態ではないため、トランザクションの影響を受けません。

[4] 接続でコミットまたはロールバックに失敗しました。 この場合、関数はSQL_ERRORを返します。

[5] 接続でコミットまたはロールバックが成功しました。 この関数は、コミットまたはロールバックが別の接続で失敗した場合にSQL_ERRORを返すか、コミットまたはロールバックがすべての接続で成功した場合にSQL_SUCCESSを返します。

[6] 接続に少なくとも 1 つのステートメントが割り当てられています。

[7] 接続に割り当てられたステートメントがありませんでした。

[8] 接続には、開いているカーソルが存在するステートメントが少なくとも 1 つあり、トランザクションがコミットまたはロールバックされたときにカーソルが保持されます ( CompletionType がSQL_COMMITされたかSQL_ROLLBACKであるかによって異なります)。 詳細については、 SQLGetInfo のSQL_CURSOR_COMMIT_BEHAVIOR属性とSQL_CURSOR_ROLLBACK_BEHAVIOR属性を参照してください。

[9] 接続に開いているカーソルがあるステートメントがある場合、トランザクションがコミットまたはロールバックされたときにカーソルは保持されませんでした。

SQLExecDirect と SQLExecute

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2] C6[3]	--

[1] 接続が自動コミット モードで、実行されたステートメントが cursor specification (SELECT ステートメントなど) でなかったか、接続が手動コミット モードで、実行されたステートメントはトランザクションを開始しませんでした。

[2] 接続は自動コミット モードで、実行されたステートメントは cursor specification (SELECT ステートメントなど) でした。

[3] 接続は手動コミット モードで、データ ソースはトランザクションを開始しました。

SQLFreeHandle

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)[1]	C0	(HY010)	(HY010)	(HY010)	(HY010)	(HY010)
(IH)[2]	(IH)	(C1)	(HY010)	(HY010)	(HY010)	(HY010)
(IH)[3]	(IH)	(IH)	(IH)	(IH)	C4[5] --[6]	--[7] C4[5] および [8] C5[6] および [8]
(IH)[4]	(IH)	(IH)	(IH)	--	--	--

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

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

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

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

[5] 接続に割り当てられたステートメントは 1 つだけでした。

[6] 接続に複数のステートメントが割り当てられていた。

[7] 接続は手動コミット モードでした。

[8] 接続は自動コミット モードでした。

SQLFreeStmt

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)[1]	(IH)	(IH)	(IH)	(IH)	--	C5[3] --[4]
(IH)[2]	(IH)	(IH)	(IH)	(IH)	--	--

[1] この行には、引数 Option がSQL_CLOSEされている場合のトランザクションが表示されます。

[2] この行には、引数 Option がSQL_UNBINDまたはSQL_RESET_PARAMSされている場合のトランザクションが表示されます。

[3] 接続は自動コミット モードで、このステートメント以外のステートメントではカーソルが開いていません。

[4] 接続が手動コミット モードであったか、自動コミット モードで、少なくとも 1 つの他のステートメントでカーソルが開かれていました。

SQLGetConnectAttr

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
IH	IH	--[1] 08003[2]	HY010	--	--	--

[1] Attribute 引数は、SQL_ATTR_ACCESS_MODE、SQL_ATTR_AUTOCOMMIT、SQL_ATTR_LOGIN_TIMEOUT、SQL_ATTR_ODBC_CURSORS、SQL_ATTR_TRACE、またはSQL_ATTR_TRACEFILE、または接続属性の値が設定されていました。

[2] Attribute 引数がSQL_ATTR_ACCESS_MODE、SQL_ATTR_AUTOCOMMIT、SQL_ATTR_LOGIN_TIMEOUT、SQL_ATTR_ODBC_CURSORS、SQL_ATTR_TRACE、またはSQL_ATTR_TRACEFILEではなく、接続属性の値が設定されていませんでした。

SQLGetDiagField と SQLGetDiagRec

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)[1]	--	--	--	--	--	--
(IH)[2]	(IH)	--	--	--	--	--
(IH)[3]	(IH)	(IH)	(IH)	(IH)	--	--
(IH)[4]	(IH)	(IH)	(IH)	--	--	--

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

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

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

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

SQLGetEnvAttr

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
IH	--	--	--	--	--	--

SQLGetFunctions

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
IH	IH	HY010	HY010	--	--	--

SQLGetInfo

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
IH	IH	--[1] 08003[2]	08003	--	--	--

[1] 引数 InfoType がSQL_ODBC_VERされました。

[2] 引数 InfoType がSQL_ODBC_VERされませんでした。

SQLMoreResults

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--[3] C5[1]

[1] 接続は自動コミット モードであり、 SQLMoreResults の呼び出しによってカーソル指定の結果セットの処理が初期化されていません。

[2] 接続は自動コミット モードで、 SQLMoreResults の呼び出しによってカーソル指定の結果セットの処理が初期化されました。

[3] 接続は手動コミット モードでした。

SQLNativeSql

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(08003)	(08003)	--	--	--

SQLPrepare

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--

[1] 接続が自動コミット モードであったか、データ ソースがトランザクションを開始しませんでした。

[2] 接続は手動コミット モードで、データ ソースはトランザクションを開始しました。

SQLSetConnectAttr

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
IH	IH	--[1] 08003[2]	HY010	--[3] 08002[4] HY011[5]	--[3] 08002[4] HY011[5]	--[3] および [6] C5[8] 08002[4] HY011[5] または [7]

[1] Attribute 引数がSQL_ATTR_TRANSLATE_LIBまたはSQL_ATTR_TRANSLATE_OPTIONされませんでした。

[2] Attribute 引数がSQL_ATTR_TRANSLATE_LIBまたはSQL_ATTR_TRANSLATE_OPTIONされました。

[3] Attribute 引数がSQL_ATTR_ODBC_CURSORSまたはSQL_ATTR_PACKET_SIZEされませんでした。

[4] Attribute 引数がSQL_ATTR_ODBC_CURSORSされました。

Attribute引数はSQL_ATTR_PACKET_SIZEされました。

[6] Attribute 引数がSQL_ATTR_AUTOCOMMITされなかったか、 Attribute 引数がSQL_ATTR_AUTOCOMMITされ、この属性を設定した場合、トランザクションはコミットされませんでした。

[7] Attribute 引数がSQL_ATTR_TXN_ISOLATIONされました。

[8] Attribute 引数がSQL_ATTR_AUTOCOMMITされ、この属性を設定するとトランザクションがコミットされました。

SQLSetEnvAttr

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	--	--	(HY010)	--	--	--

その他すべての ODBC 関数

C0 Env なし。	C1 未割り当て	C2 Allocated	C3 データが必要	C4 接続済み	C5 ステートメント	C6 取引
(IH)	(IH)	(IH)	(IH)	(IH)	--	--