функция

Описание

SQLColAttribute о SQLBindParamО SQLPararaDataО

SQLPutDataO

SQLSetCursorNarae{) SQLGetCursorNarae О SQLFetchО SQLFetchScrollО SQLGetData О

SQLCloseCursor О SQLError ()

SQLGetDiagFieldO

SQLGetDiagRec 0

SQLRowCount 0

SQLGetFunctions{}

SQLGetlnfo {)

SQLGetTypelnfo0

Возвращает информацию об указанном атрибуте заданного столбца в таблице результатов запроса

Связывает параметр инструкции SQL с адресом программного буфера

Сообщает приложению адрес параметра подготавливаемой инструкции, для которого необходимо предоставить данные, прежде чем инструкция сможет быть выполнена

Предоставляет данные для параметра подготавливаемой инструкции; эта функция может вызываться многократно, чтобы передавать данные по частям

Назначает имя набору записей

Возвращает имя набора записей

Возвращает следующую строку из таблицы результатов запроса

Возвращает указанную строку из таблицы результатов запроса

Возвращает значение указанного столбца из таблицы результатов запроса

Закрывает набор записей

Возвращает информацию об ощибке, произошедшей во время последнего вызова функции CLI

Возвращает значение указанного поля из специальной структуры CLL содержащей диагностическую информацию

Возврашает значения набора полей из специальной структуры CLf, содержащей диагностическую информацию

Возврашает количество строк, обработанных последней инструкцией SQL

Возвращает информацию о функциях CLI, поддерживаемых текущим драйвером

Возвращает общую информацию об источнике данных и драйвере, которые связаны с указанным сеансом подключения к базе данных

Возврашает информацию о поддерживаемых типах данных

Значения, возвращаемые функциями CLI

Каждая функция CLI возвращает значение типа short, которое может быть следующим:

Возвращаемое значение

Описание

0 Инструкция выполнена успешно

1 Инструкция выполнена успешно, но получено предупреждение

100 Данные не найдены (при извлечении результатов запроса)

99 Требуются дополнительные данные (не задан параметр динамиче-

ской инструкции)

-1 Ошибка в ходе выполнения инструкции SQL

-2 Ошибка - в функции задан неверный дескриптор

Универсальные функции управления дескрипторами

Эти функции используются для получения дескрипторов, используемых при выполнении функций CLI, и для освобождения дескрипторов, когда они больше не нужны функция SQLAllocHandle () получает аргумент, указывающий, какой дескриптор требуется создать Существуют также функции, непосредственно управляющие дескрипторами нужного типа, однако они считаются устаревшими, поэтому их использовать не рекомендуется

/* Создает дескриптор для использования в последующих вызовах функций CLI */

short SQLAllocHandle!

short hdlType, /* Входной: целочисленный код типа дескриптора I long inHdl, /* Входной, дескриптор среды или сеанса */

long *rtnHdl) /* Выходной; возвращаемый дескриптор */

/* Освобождает дескриптор, который был создан функцией SQLAllocHandle() */

short SQLFreeHandle{

short hdlType, /* Входной; целочисленный код типа дескриптора */ long inHdl) /* Входной: освобождаемый дескриптор */

Функции управления Средой SQL

Эти функции используются для получения дескриптора новой среды SQL и его последующего освобождения, а также для получения и установки значений атрибутов, связанных со средой SQL.

/* Создает дескриптор для новой среды SQL */ short SQLAllocEnv(

long envHdl) /* Выходной; возвращаемый дескриптор среды */

/* Освобождает дескриптор, который был создан

функцией SQLAllocEnv (; */ short SQLFreeEnv{

long envHdl) /* Входной освобождаемый дескриптор среды */

/* Получение значения указанного атрибута среды SQL */ short SQLGetEnvAttr(

long envHdl, /* Входной: дескриптор среды */

long attrCode, / Входной, целочисленный код атрибута */

void *rtnVaI, /* Выходной: буфер, в который записывается

возвращаемое значение */ long bufLen, /* Входной: длина буфера */

long *strLen) /* Выходной, указатель на буфер, в который

записывается реальная длина полученных данных */

/* Установка значения указанного атрибута среды SQL short SQLSetEnvAttr(

long envHdl, /*

long attrCode, /*

void *attrVal, I*

long StrLen) /*

Входной: дескриптор среды */ Входной; целочисленный код атрибута */ Входной; буфер с новкм значением атрибута */

Входной: длина буфера */

Функции управления сеансами подключения

Эти функции используются для управления сеансами подключения к серверу SQL Они создают и освобождают дескрипторы сеанса, устанавливают и разрывают соединение, управляют атрибутами сеанса, а также позволяют получить список доступных серверов SQL

/* Создает дескриптор для нового сеанса подключения */

short SQLAllocConnect{

long envHdl, /* Входной. дескриптор среды */

long *connHdl) /* Выходной; возвращаемый дескриптор сеанса */

/* Освобождает дескриптор, который был создан

функцией SQLAllocConnect{) */ short SQLFreeConnect(

long connHdl) /* Входной: освобождаемый дескриптор сеанса */

/* Устанавливает соединение с сервером баз данных

short SQLConnect(

long connHdl, /* Входной: дескриптор сеанса */

char *svrName, /* Входной, имя сервера баз данных */

short svrNamLen, /* Входной; длина имени сервера */

char *userName, /* Входной имя пользователя для подключения */

short usrNaruLen, /* Входной: длина имени пользователя */

char *passwd, /* Входной: пароль для подключения */

short pswLen) /* Входной: длина пароля */

/* Отключение от сервера баз данных */ short SQLDisconnect(

long connHdl) /* Входной: дескриптор сеанса */

/* Возвращает имена доступных серверов баз данных short SQLDataSources(

дескриптор среды */

определяет, описание какого сервера

из списка доступных серверов

следует получить (первый/следующий)

буфер для имени сервера */

длина буфера для имени сервера */

буфер, Б который записывается

реальная длина имени сервера */

буфер для строки описания */

длина буфера для строки описания */

буфер, в который записывается

реальная длина описания */

7.ЯЗ