次の方法で共有


ドライバーの仕様のサブキー

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 ドライバーが SQLConnectSQLDriverConnect、および SQLBrowseConnect をサポートしているかどうかを示す 3 文字の文字列。 ドライバーが SQLConnect をサポートしている場合、最初の文字は "Y"、それ以外の場合は "N" です。 ドライバーが SQLDriverConnect をサポートしている場合、2 番目の文字は "Y"、それ以外の場合は "N" です。 ドライバーが SQLBrowseConnect をサポートしている場合、3 番目の文字は "Y"、それ以外の場合は "N" です。 たとえば、ドライバーが SQLConnectSQLDriverConnect をサポートしているが、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