функции для отложенной обработки динамических параметров

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

/* Возвращает указатель на буфер или специальный тег параметра,

для которого требуется передать значение */ short SQLParamData(

long StmtHdl, /* Входной:

void

*prmTag)

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

/* Передача значения очередному динамическому параметру

выполняемой инструкции */ short SQLPutData( long StmtHdl,

Входной: дескриптор инструкции с динамическими параметрами */

void *prmData, /* Входной: буфер, содержащий значение параметра */ short prmLenInd) /* Входной: длина параметра или индикатор

значения NULL */

Функции для получения диагностической информации

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

/* Получение информации об ошибке, произошедшей во время последнего вызова функции CLI / Short SQLError (

дескриптор среды SQL */ дескриптор сеанса подключения */ дескриптор инструкции */ пятисимвольное значение переменной SQLSTATE */ указатель на буфер, в который записывается полученный системно-зависимый код ошибки */ буфер для сообщения об ошибке */ длина буфера */ указатель на буфер, в который записывается реальная длина полученного сообщения */

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

инструкцией SQL */ short SQLRowCount(

long StmtHdl, long *rowCnt)

/* Входной: дескриптор инструкции */

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

записывается количество строк */

/* Получение значений набора полей из структуры CLI,

содержащей диагностическую информацию */ short SQLGetDiagRec{

short hdlType, /* Входной:

long inHdl, /* Входной:

short recNr, /* Входной:

char *sqlState, /* Выходной:

long *nativeErr, /* Выходной:

char

short

short

*msgBuf, bufLen, *msgLen)

Выходной: Входной: Выходной:

код типа дескриптора дескриптор CLI */ номер запрашиваемой записи с информацией об ошибке */ пятисимвольное значение переменной SQLSTATE */ указатель на буфер, в который записывается полученный системно-зависимый код ошибки буфер для сообщения об ошибке длина буфера */ указатель на буфер, в который записывается реальная длина полученного сообщения */

Получение значения указанного поля из структуры CL1, содержащей диагностическую информацию */ short SQLGetDiagField(

Функции для получения информации о оиблпотеке CLI

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

/* Получение информации о конкретной реализации CLI */ short SQLGetlnfo(

* Входной:

* Входной:

* Выходной;

long short void short

connHdl, mf oType, *infoVal, bufLen,

short *infoLen)

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

/* Получение информации о поддержке конкретной функции CLI */

short SQLGetFunctions(

long connHdl, /* Входной: дескриптор сеанса */ short functionid, /* Входной; код функции */

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

записывается признак того, поддерживается ли функция */

/* Получение информации о поддерживаемых типах данных */

short SQLGetTypelnfo (

long StmtHdl, /* Входной; дескриптор инструкции */ short dataType) /* Входной: запрашиваемый тип данных */

Коды параметров функций CLI

Приведенные ниже коды передаются функциям CL1 или возвращаются функциями CLI в выходных параметрах.

Код Значение

Коды типов дескрипторов:

Дескриптор среды SQL 1

Дескриптор сеанса подключения 2

Дескриптор инструкции SQL 3

Дескриптор описателя CLI 4 Коды типов данных в SQL:

CHARACTER 1

NUMERIC 2

DECIMAL 3

INTEGER 4

SMALLINT 5

FLOAT 6

REAL 7

DOUBLE 8

DATETIME 9

INTERVAL 10

VARCHAR 12

BIT 14

Определяется реализацией < О

Коды типов данных в языке, на котором написано приложение:

CHARACTER 1

NUMERIC 2

DECIMAL 3

INTEGER 4

SMALLINT 5