ODBC 3.0 ドライバーの動作
動作の変更とは、使用する ODBC のバージョンにより変化する機能のことです。ODBC 2.0 および ODBC 3.0 ドライバーは、SQL_ATTR_ODBC_VERSION 環境属性 の設定にしたがって動作します。
- ODBC 3.0 アプリケーションは、最初に SQLAllocHandle() を呼び出して、環境ハンドルを取得します。ODBC 3.0 ドライバーは、暗黙的に SQL_ATTR_ODBC_VERSION = SQL_OV_ODBC3 を設定します。
この設定により、ODBC 3.0 アプリケーションは ODBC 3.0 の動作になります。
ODBC 3.0 アプリケーションは、SQLAllocHandle() を呼び出し、次に SQLAllocEnv() を呼び出してはなりません。 このようにすると、アプリケーションは暗黙的に ODBC 2.0 の動作にリセットされます。 アプリケーションが ODBC 2.0 の動作にリセットされるのを防ぐため 、ODBC 3.0 アプリケーションでは、常に SQLAllocHandle() を使用して 環境ハンドルを管理する必要があります。
- ODBC 2.0 アプリケーションは、最初に SQLAllocEnv() を呼び出して、環境ハンドルを取得します。ODBC 2.0 ドライバーは、暗黙的に SQL_ATTR_ODBC_VERSION = SQL_OV_ODBC2 を設定します。 この設定により、ODBC 2.0 アプリケーションは ODBC 2.0 の動作になります。
アプリケーションは、属性 SQL_ATTR_ODBC_VERSION に対して SQLGetEnvAttr() を呼び出し、ODBC のバージョンの設定を検査することができます。アプリケーションは、属性 SQL_ATTR_ODBC_VERSION に対して SQLSetEnvAttr() を呼び出し 、ODBC のバージョンを明示的に設定することができます。
前方互換性によって、以前の ODBC 2.0 ドライバーのヘッダー・ファイルを使用してコンパイル された ODBC 2.0 アプリケーション、または新しい ODBC 3.0 ヘッダー・ファイルを使用して再コンパイル された ODBC 2.0 アプリケーションが影響を受けることはありません。 これらのアプリケーションは、ODBC 3.0 ドライバーで ODBC 2.0 アプリケーションとして、引き続き実行することができます。これらの ODBC 2.0 アプリケーションは、SQLSetEnvAttr() を呼び出す必要はありません。上で述べたように、既存の ODBC 2.0 アプリケーションが SQLAllocEnv() (環境ハンドルを 割り当てる ODBC 2.0 API) を呼び出すと、ODBC 3.0 ドライバーは暗黙的に SQL_ATTR_ODBC_VERSION= SQL_OV_ODBC2 に 設定します。これにより、ODBC 3.0 ドライバーを使用する場合に、ODBC 2.0 ドライバーの動作になります。