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

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