ドライバーの仕様のサブキー
ODBC Drivers サブキーに一覧表示されている各ドライバーには、独自のサブキーがあります。 このサブキーの名前は、ODBC Drivers サブキーの対応する値と同じです。 このサブキーの下の値には、ドライバーとドライバーのセットアップ DLL の完全なパス、SQLDrivers によって返されるドライバー キーワードの値、および使用状況の数が一覧表示されます。 値の形式は次の表に示すとおりです。
| 名前 | データの種類 | データ |
|---|---|---|
| APILevel | REG_SZ | 0 | 1 | 2 |
| ConnectFunctions | REG_SZ | {Y|N}{Y|N}{Y|N} |
| CreateDSN | REG_SZ | driver-description |
| ドライバー | REG_SZ | driver-DLL-path |
| DriverODBCVer | REG_SZ | nn.nn |
| FileExtns | REG_SZ | *. file-extension1[,*. file-extension2]... |
| FileUsage | REG_SZ | 0 | 1 | 2 |
| セットアップ | REG_SZ | setup-DLL-path |
| SQLLevel | REG_SZ | 0 | 1 | 2 |
| UsageCount | REG_DWORD | count |
各キーワードの使用方法を次の表に示します。
| Keyword | 使用方法 |
|---|---|
| APILevel | ドライバーでサポートされている ODBC インターフェイス準拠レベルを示す数値。 0 = なし 1 = レベル 1 がサポートされています 2 = レベル 2 がサポートされています これは、SQLGetInfo の SQL_ODBC_INTERFACE_CONFORMANCE オプションで返される値と同じである必要があります。 |
| CreateDSN | ドライバーのインストール時に作成される 1 つ以上のデータ ソースの名前。 システム情報には、CreateDSN キーワードと共にリストされているデータ・ソースごとに、1 つのデータ・ソース仕様セクションが含まれている必要があります。 ドライバーの仕様セクションで指定されていますが、ダイアログ ボックスを表示せずにデータ ソースの仕様を作成するには、ドライバーセットアップ DLL に ConfigDSN 関数の十分な情報を含める必要があるため、これらのセクションには Driver キーワードを含めないようにしてください。 データ ソース仕様セクションの形式については、「データ ソース仕様サブキー」を参照してください。 |
| ConnectFunctions | ドライバーが SQLConnect、SQLDriverConnect、および SQLBrowseConnect をサポートしているかどうかを示す 3 文字の文字列。 ドライバーが SQLConnect をサポートしている場合、最初の文字は "Y"、それ以外の場合は "N" です。 ドライバーが SQLDriverConnect をサポートしている場合、2 番目の文字は "Y"、それ以外の場合は "N" です。 ドライバーが SQLBrowseConnect をサポートしている場合、3 番目の文字は "Y"、それ以外の場合は "N" です。 たとえば、ドライバーが SQLConnect と SQLDriverConnect をサポートしているが、SQLBrowseConnect をサポートしていない場合、3 文字の文字列は "YYN" になります。 |
| DriverODBCVer | ドライバーがサポートする ODBC のバージョンを含む文字列。 バージョンは nn.nn という形式で、最初の 2 桁はメジャー バージョン、次の 2 桁はマイナー バージョンです。 このマニュアルで説明されている ODBC のバージョンでは、ドライバーは "03.00" を返す必要があります。 これは、SQLGetInfo の SQL_DRIVER_ODBC_VER オプションで返される値と同じである必要があります。 |
| FileExtns | ファイル ベースのドライバーの場合、ドライバーが使用できるファイルの拡張子のコンマ区切りの一覧。 たとえば、dBASE ドライバーで *.dbf を指定し、書式設定されたテキスト ファイル ドライバーで *.txt,*.csv を指定する場合があります。 アプリケーションでこの情報を使用する方法の例については、FileUsage キーワードを参照してください。 |
| FileUsage | ファイル ベースのドライバーがデータ ソース内のファイルを直接処理する方法を示す数値。 0 = ドライバーはファイル ベースのドライバーではありません。 たとえば、ORACLE ドライバーは DBMS ベースのドライバーです。 1 = ファイル ベースのドライバーは、データ ソース内のファイルをテーブルとして扱います。 たとえば、Xbase ドライバーは、各 Xbase ファイルをテーブルとして扱います。 2 = ファイル ベースのドライバーは、データ ソース内のファイルをカタログとして扱います。 たとえば、Microsoft Access ドライバーは、各 Microsoft Access ファイルを完全なデータベースとして扱います。 アプリケーションでは、これを使用して、ユーザーがデータを選択する方法を決定できます。 たとえば、Xbase と Paradox のユーザーは、多くの場合、データはファイルに格納されると考えますが、ORACLE と Microsoft Access のユーザーは通常、データをテーブルに格納していると考えます。 ユーザーが [ファイル] メニューから [データ ファイルを開く] を選択すると、アプリケーションで [Windows ファイルを開く] 共通ダイアログ ボックスが表示される場合があります。 ファイルの種類の一覧では、ConnectFunctions キーワードの値の 2 番目の文字として FileUsage 値 1 と "Y" を指定するドライバーの FileExtns キーワードで指定されたファイル拡張子を使用します。 ユーザーがファイルを選択すると、アプリケーションは DRIVER キーワードを使用して SQLDriverConnect を呼び出し、SELECT * FROM テーブル名ステートメントを実行します。 ユーザーが [ファイル] メニューから [データのインポート] を選択すると、アプリケーションは、FileUsage 値 0 または 2、および ConnectFunctions キーワードの値の 2 番目の文字として "Y" を指定するドライバーの説明の一覧を表示できます。 ユーザーがドライバーを選択すると、アプリケーションは DRIVER キーワードを使用して SQLDriverConnect を呼び出し、カスタムの [テーブルの選択] ダイアログ ボックスを表示します。 |
| SQLLevel | ドライバーでサポートされている SQL-92 文法を示す数値: 0 = SQL-92 エントリ 1 = FIPS127-2 Transitional 2 = SQL-92 Intermediate 3 = SQL-92 Full これは、SQLGetInfo の SQL_SQL_CONFORMANCE オプションで返される値と同じである必要があります。 |
使用量のカウントについては、このセクションの前半の「使用状況カウント」を参照してください。
アプリケーションでは、使用量のカウントを設定しないでください。 ODBC はこのカウントを保持します。
たとえば、書式設定されたテキスト ファイルのドライバーに Text.dll という名前のドライバー DLL があり、Txtsetup.dll という別のドライバー セットアップ DLL があり、3 回インストールされているとします。 ドライバーがレベル 1 API 準拠レベルをサポートし、SQL 文法の最小準拠レベルをサポートし、ファイルをテーブルとして扱い、.txt および .csv 拡張子を持つファイルを使用できる場合、Text サブキーの下の値は次のようになります。
APILevel : REG_SZ : 1
ConnectFunctions : REG_SZ : YYN
Driver : REG_SZ : C:\WINDOWS\SYSTEM32\TEXT.DLL
DriverODBCVer : REG_SZ : 03.00.00
FileExtns : REG_SZ : *.txt,*.csv
FileUsage : REG_SZ : 1
Setup : REG_SZ : C:\WINDOWS\SYSTEM32\TXTSETUP.DLL
SQLLevel : REG_SZ : 0
UsageCount : REG_DWORD : 0x3