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 |
- （凡例）
-
○：DABrokerドライバで使えるODBC関数です。
×：DABrokerドライバで使えないODBC関数です。
|
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エラー |
- （凡例）
-
○：DABrokerドライバで使えるODBC関数です。
×：DABrokerドライバで使えないODBC関数です。
(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 |
- （凡例）
-
○：DABrokerドライバで使えるODBC関数です。
×：DABrokerドライバで使えないODBC関数です。
|
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 |
- （凡例）
-
○：DABrokerドライバで使えるODBC関数です。
×：DABrokerドライバで使えないODBC関数です。