Подразделы спецификаций драйверов

Каждый драйвер, указанный в подразделе "Драйверы ODBC", имеет собственный подраздел. Этот подраздел имеет то же имя, что и соответствующее значение в подразделе "Драйверы ODBC". Значения в этом подразделе перечисляют полные пути библиотек DLL драйвера и драйвера, значения драйвера ключевое слово, возвращаемых SQLDrivers, и количество использования. Форматы значений, как показано в следующей таблице.

Имя. Тип данных Data
APILevel REG_SZ 0 | 1 2 |
Подключение Functions 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. Эти разделы не должны включать драйвер ключевое слово, так как это указано в разделе спецификации драйвера, но должно содержать достаточно сведений для функции ConfigDSN в библиотеке DLL установки драйвера, чтобы создать спецификацию источника данных без отображения диалоговых окон. Формат раздела спецификации источника данных см . в подразделах спецификации источника данных.
Подключение Functions Трехзначная строка, указывающая, поддерживает ли драйвер SQL Подключение, SQLDriver Подключение и SQLBrowse Подключение. Если драйвер поддерживает SQL Подключение, первый символ — Y; в противном случае — N. Если драйвер поддерживает SQLDriver Подключение, второй символ — Y; в противном случае — N. Если драйвер поддерживает SQLBrowse Подключение, третий символ — Y; в противном случае — N. Например, если драйвер поддерживает SQL Подключение и SQLDriver Подключение но не SQLBrowse Подключение, то строка с тремя символами — 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 в качестве второго символа значения Подключение Functions ключевое слово. После выбора файла приложение вызовет SQLDriver Подключение с драйверомключевое слово, а затем выполните инструкцию SELECT * FROM table-name.

Когда пользователь выбирает импорт данных из меню "Файл", приложение может отобразить список описаний драйверов, указывающих значение FileUsage 0 или 2, а "Y" в качестве второго символа значения Подключение Functions ключевое слово. После выбора драйвера приложение вызовет SQLDriver Подключение с драйверомключевое слово, а затем откроется настраиваемое диалоговое окно "Выбор таблицы".
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