Опубликован: 20.12.2005 | Уровень: специалист | Доступ: свободно | ВУЗ: Московский государственный университет имени М.В.Ломоносова
Лекция 2:
Функции ODBC API
Функции установки
Группа функций установки (setup DLL) объединяет функции, предназначенные для конфигурирования драйверов и источников данных. В следующей таблице приведены функции, относящиеся к данной группе.
| Функция | Описание |
|---|---|
| ConfigDriver | Выполняет установку или удаление драйвера |
| ConfigDSN | Выполняет добавление, изменение или удаление источника данных |
| ConfigTranslator | Возвращает используемые по умолчанию опции преобразования |
Функции инсталляции
Группа функций инсталляции (installer DLL) объединяет функции, предназначенные для установки ODBC и конфигурирования источников данных. В следующей таблице приведены функции, относящиеся к данной группе.
| Функция | Описание |
|---|---|
| Установка ODBC | |
| SQLConfigDriver | Загружает setup DLL для конкретного драйвера |
| SQLGetInstalledDrivers | Возвращает список установленных драйверов |
| SQLInstallDriverEx | Добавляет в реестр данные о драйвере |
| SQLInstallDriverManager | Возвращает каталог, назначенный для менеджера драйверов |
| SQLInstallerError | Возвращает информацию об ошибке выполнения функции инсталляции |
| SQLInstallTranslatorEx | Добавляет в реестр данные о трансляторе |
| SQLRemoveDriver | Удаляет из реестра данные о драйвере |
| SQLRemoveDriverManager | Изменяет или удаляет данные о базовых компонентах ODBC из реестра |
| SQLRemoveTranslator | Удаляет из реестра данные о трансляторе |
| Конфигурирование источников данных | |
| SQLConfigDataSource | Вызывает setup DLL для конкретного драйвера |
| SQLCreateDataSource | Отображает диалог для добавления источника данных |
| SQLGetConfigMode | Запрашивает режим конфигурации, позволяющий определить, где в реестре Windows искать секцию ODBC.INI. Если функция возвращает значение параметра равным ODBC_USER_DSN, то DSN является пользовательским и вход ODBC.INI находится в разделе HKEY_CURRENT_USER (Software|ODBC), а если функция возвращает значение параметра равным ODBC_SYSTEM_DSN или ODBC_BOTH_DSN, то вход ODBC.INI находится в разделе HKEY_LOCAL_MACHINE |
| SQLGetPrivateProfileString | Считывает значение в реестр |
| SQLGetTranslator | Показывает диалог для выбора транслятора |
| SQLManageDataSources | Отображает диалог для конфигурирования драйверов и источников данных |
| SQLReadFileDSN | Читает информацию о DSN из файла |
| SQLRemoveDefaultDataSource | Удаляет источник данных по умолчанию |
| SQLRemoveDSNFromIni | Удаляет источник данных |
| SQLSetConfigMode | Устанавливает режим конфигурации, указывающий, где в реестре будет использоваться вход ODBC.INI |
| SQLValidDSN | Проверяет правильность имени источника данных |
| SQLWriteDSNToIni | Добавляет источник данных |
| SQLWriteFileDSN | Записывает информацию о DSN в файл |
| SQLWritePrivateProfileString | Записывает значение из реестра Windows |
Соответствие версий ODBC API
Если приложение использует функции ODBC 2.x с менеджером драйверов ODBC 3.x, то менеджер драйверов подменяет вызываемую функцию и передает драйверу ODBC 3.x вызов функции в соответствии со следующей таблицей.
| Функции ODBC 2.x | Функции ODBC 3.x |
|---|---|
| SQLAllocConnect | SQLAllocHandle |
| SQLAllocEnv | SQLAllocHandle |
| SQLAllocStmt | SQLAllocHandle |
| SQLBindParam (для стандарта X/Open и ISO) | SQLBindParameter |
| SQLColAttributes | SQLColAttribute |
| SQLError | SQLGetDiagRec |
| SQLFreeConnect | SQLFreeHandle |
| SQLFreeEnv | SQLFreeHandle |
| SQLFreeStmt | SQLFreeHandle |
| SQLGetConnectOption | SQLGetConnectAttr |
| SQLGetStmtOption | SQLGetStmtAttr |
| SQLParamOptions | SQLSetStmtAttr |
| SQLSetConnectOption | SQLSetConnectAttr |
| SQLSetParam [функция ODBC 1.0] | SQLBindParameter |
| SQLSetScrollOption | SQLSetStmtAttr |
| SQLSetStmtOption | SQLSetStmtAttr |
| SQLTransact | SQLEndTran |
