SQLGetInfo (カーソル ライブラリ)
重要
この機能は、Windows の将来のバージョンで削除される予定です。 新しい開発作業ではこの機能を使用しないでください。また、現在この機能を使用しているアプリケーションの変更を計画してください。 Microsoft では、ドライバーのカーソル機能を使用することをお勧めします。
このトピックでは、カーソル ライブラリでの SQLGetInfo 関数の使用について説明します。 SQLGetInfo の一般的な情報については、「SQLGetInfo 関数」を参照してください。
カーソル ライブラリは、 InfoType (| はビットごとの OR を表します) の次の値の値を返します。 InfoType の他のすべての値に対して、ドライバーで SQLGetInfo を呼び出します。
| Infotype | 戻り値 |
|---|---|
| SQL_BOOKMARK_PERSISTENCE | SQL_BP_SCROLL |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES1 | 0 |
| SQL_DYNAMIC_CURSOR_ATTRIBUTES2 | 0 |
| SQL_FETCH_DIRECTION[1] | SQL_FD_FETCH_ABSOLUTE |SQL_FD_FETCH_FIRST |SQL_FD_FETCH_LAST |SQL_FD_FETCH_NEXT |SQL_FD_FETCH_PRIOR |SQL_FD_FETCH_RELATIVE |SQL_FD_FETCH_BOOKMARK |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT |SQL_CA1_ABSOLUTE |SQL_CA1_RELATIVE |SQL_CA1_LOCK_NO_CHANGE |SQL_CA1_POS_POSITION |SQL_CA1_POSITIONED_DELETE |SQL_CA1_POSITIONED_UPDATE |SQL_CA1_SELECT_FOR_UPDATE |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR |SQL_CA2_OPT_VALUES_CONCURRENCY |SQL_CA2_SENSITIVITY_UPDATES |
| SQL_GETDATA_EXTENSIONS | SQL_GD_BLOCK |ドライバーによって返されるすべての値 注:SQLFetchScroll を使用してデータを取得する場合、 SQLGetData は、SQL_GD_ANY_COLUMNとSQL_GD_BOUNDビットマスクで指定された機能をサポートします。 |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES1 | 0 |
| SQL_KEYSET_DRIVEN_CURSOR_ATTRIBUTES2 | 0 |
| SQL_LOCK_TYPES[1] | SQL_LCK_NO_CHANGE |
| SQL_STATIC_CURSOR_ATTRIBUTES1 | SQL_CA1_NEXT |SQL_CA1_ABSOLUTE |SQL_CA1_RELATIVE |SQL_CA1_BOOKMARK |SQL_CA1_LOCK_NO_CHANGE |SQL_CA1_POS_POSITION |SQL_CA1_POSITIONED_DELETE |SQL_CA1_POSITIONED_UPDATE |SQL_CA1_SELECT_FOR_UPDATE |
| SQL_STATIC_CURSOR_ATTRIBUTES2 | SQL_CA2_READ_ONLY_CONCUR |コンカレンシーのSQL_CA2_OPT_VALUES_ |SQL_CA2_SENSITIVITY_UPDATES |
| SQL_POS_OPERATIONS[1] | SQL_POS_POSITION |
| SQL_POSITIONED_STATEMENTS[1] | SQL_PS_POSITIONED_DELETE |SQL_PS_POSITIONED_UPDATE |SQL_PS_SELECT_FOR_UPDATE |
| SQL_ROW_UPDATES | "Y" |
| SQL_SCROLL_CONCURRENCY[1] | SQL_SCCO_READ_ONLY |SQL_SCCO_OPT_VALUES |
| SQL_SCROLL_OPTIONS | SQL_SO_FORWARD_ONLY |SQL_SO_STATIC |
| SQL_STATIC_SENSITIVITY[1] | SQL_SS_UPDATES |
[1] カーソル ライブラリが ODBC 2.x ドライバーで使用されている場合にのみ使用されます。
重要
カーソル ライブラリは、トランザクションがコミットまたはロールバックされるときに、データ ソースと同じカーソル動作を実装します。 つまり、 SQLEndTran を呼び出すか、SQL_ATTR_AUTOCOMMIT接続属性を使用してトランザクションをコミットまたはロールバックすると、データ ソースがアクセス プランを削除し、接続上のすべてのステートメントのカーソルを閉じる可能性があります。 詳細については、 SQLGetInfo のSQL_CURSOR_COMMIT_BEHAVIORとSQL_CURSOR_ROLLBACK_BEHAVIOR情報の種類に関するページを参照してください。