5.5.1 DABrokerドライバで取得できるODBC関数のオプション値
DABrokerドライバ(DBPARTNER/Serverドライバ)で取得できるODBC関数のオプション値について説明します。
(1) SQLSetConnectOption関数,SQLSetStmtOption関数
SQLSetConnectOption関数で取得できるオプション値とサポート状況を表5-23に,SQLSetStmtOption関数で取得できるオプション値とサポート状況を表5-24に示します。表の備考は,ODBC関数がサポートされたODBCのバージョンを示します。
fOption |
値 |
vParam |
値 |
サポート状況 |
指定時の処置 |
備考 |
---|---|---|---|---|---|---|
SQL_ACCESS_MODE |
101 |
SQL_MODE_READ_WRITE |
0UL |
○ |
正常処理 |
ODBC 1.0 |
SQL_MODE_READ_ONLY |
1UL |
○ |
正常処理 |
|||
SQL_AUTOCOMMIT |
102 |
SQL_AUTOCOMMIT_ON |
1UL |
○ |
正常処理 |
ODBC 1.0 |
SQL_AUTOCOMMIT_OFF |
0UL |
○ |
正常処理 |
|||
SQL_CURRENT_QUALIFIER |
109 |
データソースが使う修飾語名も含むNULL終端文字列 |
− |
× |
S1C00エラー |
ODBC 2.0 |
SQL_LOGIN_TIMEOUT |
103 |
秒数に対応する32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 1.0 |
SQL_ODBC_CURSORS |
110 |
SQL_CUR_USE_DRIVER |
2UL |
× |
S1C00エラー |
ODBC 2.0 |
SQL_CUR_USE_ODBC |
1UL |
× |
S1C00エラー |
|||
SQL_CUR_USE_IF_NEEDED |
0UL |
× |
S1C00エラー |
|||
SQL_OPT_TRACE |
104 |
SQL_OPT_TRACE_OFF |
0UL |
○ |
正常処理 |
ODBC 1.0 |
SQL_OPT_TRACE_ON |
1UL |
× |
S1009エラー |
|||
SQL_OPT_TRACEFILE |
105 |
トレースファイル名を含むNULLで終端文字列 |
− |
○ |
正常処理 |
ODBC 1.0 |
SQL_PACKET_SIZE |
112 |
バイト単位のネットワークパケットサイズを示す32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 2.0 |
SQL_QUIET_MODE |
111 |
32ビットウィンドウハンドル(hwnd) |
− |
× |
S1C00エラー |
ODBC 2.0 |
SQL_TRANSLATE_DLL |
106 |
DLL名を含むNULL終端文字列 |
− |
× |
S1C00エラー |
ODBC 1.0 |
SQL_TRANSLATE_OPTION |
107 |
変換DLLに渡される32ビットのフラグの値 |
− |
× |
S1C00エラー |
ODBC 1.0 |
SQL_TXN_ISOLATION |
108 |
現在のhdbcに関するトランザクション分離レベルを設定する32ビットのビットマスク |
− |
○ |
正常処理 |
ODBC 1.0 |
fOption |
値 |
vParam |
値 |
サポート状況 |
指定時の処置 |
備考 |
---|---|---|---|---|---|---|
SQL_ASYNC_ENABLE |
4 |
SQL_ASYNC_ENABLE_OFF |
0UL |
○ |
正常処理 |
ODBC 1.0 |
SQL_ASYNC_ENABLE_ON |
1UL |
○ |
正常処理 |
|||
SQL_BIND_TYPE |
5 |
バインド方向を設定する32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 1.0 |
SQL_CONCURRENCY |
7 |
SQL_CONCUR_READ_ONLY |
1 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_CONCUR_LOCK |
2 |
× |
S1C00エラー |
|||
SQL_CONCUR_ROWVER |
3 |
× |
S1C00エラー |
|||
SQL_CONCUR_VALUES |
4 |
× |
S1C00エラー |
|||
SQL_CURSOR_TYPE |
6 |
SQL_CURSOR_FORWARD_ONLY |
0UL |
× |
S1C00エラー |
ODBC 2.0 |
SQL_CURSOR_STATIC |
3UL |
× |
S1C00エラー |
|||
SQL_CURSOR_KEYSET_DRIVEN |
1UL |
× |
S1C00エラー |
|||
SQL_CURSOR_DYNAMIC |
2UL |
× |
S1C00エラー |
|||
SQL_KEYSET_SIZE |
8 |
キーセット駆動カーソルに対するキーセットの行数を指定する32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 2.0 |
SQL_MAX_LENGTH |
3 |
ドライバが文字又はバイナリ列から返すデータの最大量を指定する32ビット整数値 |
− |
○ |
正常処理 |
ODBC 1.0 |
SQL_MAX_ROWS |
1 |
アプリケーションに返すSELECTステートメントの最大行数に相当する32ビット整数値 |
− |
○ |
正常処理 |
ODBC 1.0 |
SQL_NOSCAN |
2 |
SQL_NOSCAN_OFF |
0UL |
○ |
正常処理 |
ODBC 1.0 |
SQL_NOSCAN_ON |
1UL |
○ |
正常処理 |
|||
SQL_QUERY_TIMEOUT |
0 |
SQLステートメントがアプリケーションに実行して戻るまでの待ち時間を示す秒数に相当する32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 1.0 |
SQL_RETRIEVE_DATA |
11 |
SQL_RD_ON |
1UL |
× |
S1C00エラー |
ODBC 2.0 |
SQL_RD_OFF |
0UL |
× |
S1C00エラー |
|||
SQL_ROWSET_SIZE |
9 |
行セットの行数を指定する32ビット整数値 |
− |
× |
S1C00エラー |
ODBC 2.0 |
SQL_SIMULATE_CURSOR |
10 |
SQL_SC_NON_UNIQUE |
0UL |
× |
S1C00エラー |
ODBC 2.0 |
SQL_SC_TRY_UNIQUE |
1UL |
× |
S1C00エラー |
|||
SQL_SC_UNIQUE |
2UL |
× |
S1C00エラー |
|||
SQL_USE_BOOKMARKS |
12 |
SQL_UB_OFF |
0UL |
× |
S1C00エラー |
ODBC 2.0 |
SQL_UB_ON |
1UL |
× |
S1C00エラー |
(2) SQLGetConnectOption関数,SQLGetStmtOption関数
SQLGetConnectOption関数で取得できるオプション値とサポート状況を表5-25に,SQLGetStmtOption関数で取得できるオプション値とサポート状況を表5-26に示します。表の備考は,ODBC関数がサポートされたODBCのバージョンを示します。
fOption |
値 |
サポート状況 |
指定時の処置 |
備考 |
---|---|---|---|---|
SQL_ACCESS_MODE |
101 |
○ |
正常処理 |
ODBC 1.0 |
SQL_AUTOCOMMIT |
102 |
○ |
正常処理 |
ODBC 1.0 |
SQL_CURRENT_QUALIFIER |
109 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_LOGIN_TIMEOUT |
103 |
× |
S1C00エラー |
ODBC 1.0 |
SQL_ODBC_CURSORS |
110 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_OPT_TRACE |
104 |
○ |
正常処理 |
ODBC 1.0 |
SQL_OPT_TRACEFILE |
105 |
○ |
正常処理 |
ODBC 1.0 |
SQL_PACKET_SIZE |
112 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_QUIET_MODE |
111 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_TRANSLATE_DLL |
106 |
× |
S1C00エラー |
ODBC 1.0 |
SQL_TRANSLATE_OPTION |
107 |
× |
S1C00エラー |
ODBC 1.0 |
SQL_TXN_ISOLATION |
108 |
○ |
正常処理 |
ODBC 1.0 |
fOption |
値 |
サポート状況 |
指定時の処置 |
備考 |
---|---|---|---|---|
SQL_ASYNC_ENABLE |
4 |
○ |
正常処理 |
ODBC 1.0 |
SQL_BIND_TYPE |
5 |
× |
S1C00エラー |
ODBC 1.0 |
SQL_CONCURRENCY |
7 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_CURSOR_TYPE |
6 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_KEYSET_SIZE |
8 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_MAX_LENGTH |
3 |
○ |
正常処理 |
ODBC 1.0 |
SQL_MAX_ROWS |
1 |
○ |
正常処理 |
ODBC 1.0 |
SQL_NOSCAN |
2 |
○ |
正常処理 |
ODBC 1.0 |
SQL_QUERY_TIMEOUT |
0 |
× |
S1C00エラー |
ODBC 1.0 |
SQL_RETRIEVE_DATA |
11 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_ROWSET_SIZE |
9 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_SIMULATE_CURSOR |
10 |
× |
S1C00エラー |
ODBC 2.0 |
SQL_USE_BOOKMARKS |
12 |
× |
S1C00エラー |
ODBC 2.0 |