Подразделы спецификаций драйверов
Каждый драйвер, указанный в подразделе "Драйверы ODBC", имеет собственный подраздел. Этот подраздел имеет то же имя, что и соответствующее значение в подразделе "Драйверы ODBC". Значения в этом подразделе перечислены полные пути библиотек DLL установки драйвера и драйвера, значения ключевых слов драйвера, возвращаемых SQLDrivers, и количество использования. Форматы значений, как показано в следующей таблице.
| Имя. | Тип данных | Data |
|---|---|---|
| APILevel | REG_SZ | 0 | 1 2 | |
| ConnectFunctions | REG_SZ | {Y|N}{Y N}{Y||N} |
| CreateDSN | REG_SZ | описание драйвера |
| Драйвер | 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 |
Использование каждого ключевого слова показано в следующей таблице.
| Ключевое слово | Использование |
|---|---|
| APILevel | Число, указывающее уровень соответствия интерфейса ODBC, поддерживаемый драйвером: 0 = нет 1 = поддерживаемый уровень 1 2 = поддерживаемый уровень 2 Это значение должно совпадать со значением, возвращаемым для параметра SQL_ODBC_INTERFACE_CONFORMANCE в SQLGetInfo. |
| CreateDSN | Имя одного или нескольких источников данных, создаваемых при установке драйвера. Сведения о системе должны содержать один раздел спецификации источника данных для каждого источника данных, указанного с ключевым словом CreateDSN . Эти разделы не должны включать ключевое слово Driver , так как это указано в разделе спецификации драйвера, но должно содержать достаточно сведений для функции ConfigDSN в библиотеке DLL установки драйвера, чтобы создать спецификацию источника данных без отображения диалоговых окон. Формат раздела спецификации источника данных см . в подразделах спецификации источника данных. |
| ConnectFunctions | Трехзначная строка, указывающая, поддерживает ли драйвер SQLConnect, SQLDriverConnect и SQLBrowseConnect. Если драйвер поддерживает SQLConnect, первый символ — Y; в противном случае — N. Если драйвер поддерживает SQLDriverConnect, второй символ — Y; в противном случае — N. Если драйвер поддерживает SQLBrowseConnect, третий символ — Y; в противном случае — N. Например, если драйвер поддерживает SQLConnect и SQLDriverConnect, но не SQLBrowseConnect, то строка с тремя символами — YYN. |
| DriverODBCVer | Символьная строка с версией ODBC, которую поддерживает драйвер. Версия формы nn.nn, где первые две цифры являются основной версией, а следующие две цифры являются дополнительной версией. Для версии ODBC, описанной в этом руководстве, драйвер должен вернуть "03.00". Это значение должно совпадать со значением, возвращаемым для параметра SQL_DRIVER_ODBC_VER в SQLGetInfo. |
| FileExtns | Для драйверов на основе файлов можно использовать список расширений файлов, разделенных запятыми. Например, драйвер dBASE может указать *.dbf и отформатированный текстовый файл драйвер может указать *.txt,*.csv. Пример использования этой информации в приложении см. в ключевом слове FileUsage . |
| FileUsage | Число, указывающее, как драйвер на основе файлов непосредственно обрабатывает файлы в источнике данных. 0 = драйвер не является драйвером на основе файлов. Например, драйвер ORACLE — это драйвер на основе СУБД. 1 = драйвер на основе файлов обрабатывает файлы в источнике данных в виде таблиц. Например, драйвер Xbase обрабатывает каждый Xbase-файл как таблицу. 2 = Драйвер на основе файлов обрабатывает файлы в источнике данных как каталог. Например, драйвер Microsoft Access обрабатывает каждый файл Microsoft Access как полную базу данных. Приложение может использовать это для определения того, как пользователи будут выбирать данные. Например, пользователи Xbase и Paradox часто считают данные хранимыми в файлах, а пользователи ORACLE и Microsoft Access обычно считают данные хранимыми в таблицах. Когда пользователь выбирает файл open Data в меню "Файл", приложение может отобразить общее диалоговое окно "Открыть файл Windows". Список типов файлов будет использовать расширения файлов, указанные с ключевым словом FileExtns для драйверов, которые указывают значение FileUsage 1 и Y в качестве второго символа значения ключевого слова ConnectFunctions . После выбора файла приложение вызовет SQLDriverConnect с ключевым словом DRIVER, а затем выполните инструкцию SELECT * FROM table-name. Когда пользователь выбирает импорт данных из меню "Файл ", приложение может отобразить список описаний драйверов, указывающих значение FileUsage 0 или 2, а "Y" — второй символ значения ключевого слова ConnectFunctions . После выбора драйвера приложение вызовет SQLDriverConnect с ключевым словом DRIVER и отобразит диалоговое окно выбора таблицы . |
| SQLLevel | Число, указывающее грамматику SQL-92, поддерживаемую драйвером: 0 = запись SQL-92 1 = переходный FIPS127-2 2 = ПРОМЕЖУТОЧНЫЙ SQL-92 3 = SQL-92 Full Это должно совпадать со значением, возвращаемым для параметра SQL_SQL_CONFORMANCE в SQLGetInfo. |
Сведения о счетчиках использования см . в разделе "Подсчет использования" ранее в этом разделе.
Приложения не должны задавать количество использования. ODBC будет поддерживать это число.
Например, предположим, что драйвер для форматированных текстовых файлов содержит библиотеку DLL драйвера с именем Text.dll, отдельную библиотеку установки драйвера с именем Txtsetup.dll и установлен три раза. Если драйвер поддерживает уровень соответствия API уровня 1, поддерживает минимальный уровень соответствия грамматики 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