Приложение 2. Характеристики объектов LinAPI

Характеристики соединения, которые можно получить

ХарактеристикаТип данныхОписание
cDBDesc L_WORDИнформация о БД, с которой связан ЛИНТЕР-сервер
cNodeName L_CHAR(8)Имя ЛИНТЕР-сервера
cConnFlags L_LONGРежимы работы по соединению (транзакции и кодировки)
cChannelID L_LONGИдентификатор соединения

Характеристики соединения/курсора, которые можно получить/установить

ХарактеристикаТип данныхСвойствоОписание
cPriority L_LONGR/WПриоритет соединения
cApiCode L_LONGRКод сообщения LinAPI
cLinCode L_LONGRКод завершения СУБД ЛИНТЕР последней операции по соединению
cSysCode L_LONGRКод сообщения ОС, сопровождающий код завершения СУБДЛИНТЕР
cStrNumber L_LONGRНомер строки запроса, где встречена ошибка трансляции
cPosNumber L_LONGRНомер позиции в строке запроса, где встречена ошибка трансляции
cTransMode L_LONGRРежим обработки транзакций соединения
cWaitComplete L_BOOLWЖдать/не ждать завершения асинхронной операции
cWaitTimeout L_LONGWДлительность ожидания завершения асинхронной операции
cUserData void *R/WПользовательское значение параметра асинхронной функции

Характеристики курсора, которые можно получить/установить

ХарактеристикаТип данныхСвойствоОписание
cSelectRowCount L_LONGRЧисло записей в выборке данных
cRowCount L_LONGRКоличество записей, обработанных последним SQL-оператором
cColumnCount L_LONGRКоличество столбцов в выборке данных
cStmtType L_LONGRТип последнего выполненного оператора (см. Идентификаторы операторов)
cCurrentRow L_LONGRНомер текущей записи в выборке данных
cCurrentRowID L_LONGR

Примечание

Характеристика устарела, использовать не рекомендуется.

cExecStmt L_LONGRКоличество выполненных (за один вызов Execute) операторов
cExecRow L_LONGRКоличество обработанных (за один вызов Execute) записей
cAnswerDesc структура t_ParamDescRОписание столбца выборки данных
cAnswerSize L_LONGRРазмер записи выборки данных (в байтах)
cStmtNumber L_LONGRНомер текущего оператора
cParamNumber L_LONGRНомер параметра, при обработке которого произошла ошибка
cPriority L_LONGR/WПриоритет курсора
cConnectID L_LONGRНомер соединения, по которому открыт курсор
cTransMode L_LONGRРежим обработки транзакций курсора
cApiCode L_LONGRКод завершения LinAPI
cLinCode L_LONGRКод завершения СУБД ЛИНТЕР последней операции по курсору
cSysCode L_LONGRКод завершения ОС, детализирующий код завершения СУБД ЛИНТЕР
cStrNumber L_LONGRНомер строки запроса, где встречена ошибка трансляции
cPosNumber L_LONGRНомер позиции в строке запроса, где встречена ошибка трансляции
cCursorName L_CHAR(66)R/WИмя курсора
cNullIndicator L_LONGRПризнак NULL-значения
cIsAutoInc L_LONGRПризнак AUTOINC-значения
cProcErrNum L_LONGR/WКоличество ошибок при трансляции процедуры
cProcArgNum L_LONGRКоличество аргументов в процедуре
cProcArgDesc структура ARGPROC_OUTRОписание аргумента процедуры
cProcArgName L_CHAR(66)RИмя аргумента процедуры
cProcCursorArg L_LONGR1 – если параметр является курсором, 0– в противном случае
cWaitComplete L_BOOLWЖдать/не ждать завершения асинхронной операции
cBlobLength L_LONGRДлина BLOB-данных
cBlobType L_LONGRТип BLOB-данных
cWaitTimeout L_LONGWДлительность ожидания завершения асинхронной операции
cUserData void *R/WПользовательское значение параметра асинхронной функции
cIsUpdatable L_LONGRКурсорная выборка данных обновляемая
cIsInCallback L_LONGRПризнак наличия функции обратного вызова

Характеристики оператора, которые можно получить/установить

Тип характеристикиТип данныхСвойствоОписание
sParamCount L_LONGRЧисло параметров в операторе
sAnswerDesc структура t_ParamDesc RОписание столбца выборки данных
sColumnCount L_LONGRЧисло столбцов в выборке данных
sParamDesc структура t_ParamDescRОписание параметра
sConnectID L_LONGRИдентификатор соединения, по которому создан оператор
sApiCode L_LONGRКод завершения LinAPI
sIsAutoInc L_LONGRПризнак AUTOINC-значения
sStmtType L_LONGRИдентификатор типа оператора (см. Идентификаторы операторов)
sParamType L_LONGRТип параметра (pInput, pOutput, pInputOutput)
sParamMap L_LONGRПорядковый номер столбца для параметра в выборке данных
sUserData void *R/WПользовательское значение параметра асинхронной функции

Идентификаторы операторов

ИдентификатороператораЗначение
sySelect 12
syInsert 13
syUpdate 14
syDelete 15
syCreate 16
syAlter 17
syDrop 18
syGrant 19
syRevoke 20
sySet 21
syCommit 22
syRollBack 23
syPress 24
syRebuild 25
syWait 26
syClear 27
syLock 28
syUnlock 29
syExecute 30
syStartAppend 31
syEndAppend 32
syTestTable 33
syTable 34
syValues 35
syExecuteBlock 36

Типы данных в LinAPI

Идентификатор типа LinAPIСоответствующий тип данных
call-интерфейса 1)
Описание данных
tChar DT_CHAR Символьная строка (может содержать двоичный нуль)
tByte DT_BYTE Буфер байтов фиксированной длины
tString DT_CHAR Символьная строка, заканчивающаяся двоичным нулем
tSmallInt DT_INTEGER Короткое целое число
tInteger, tInt DT_INTEGER Целое число
tReal DT_REAL Действительное число
tDouble DT_REAL Действительное число двойной точности
tNumeric, tDecimal, tDec DT_DECIMAL Действительное число, соответствует типу DECIMAL в СУБД ЛИНТЕР
tDate, tTimeStamp DT_DATE Дата + время, тип, соответствующий типу DATE в СУБД ЛИНТЕР
tBlob DT_BLOB BLOB-значение
tBigInt DT_INTEGER Длинное целое число
tVarChar DT_VARCHAR Символьная строка переменной длины (может содержать двоичный нуль)
tVarByte DT_VARBYTE Буфер байтов переменной длины
tBoolean DT_BOOL Логическое значение
tNChar DT_NCHAR Символьная UNICODE-строка фиксированной длины
tNVarChar DT_NVARCHAR Символьная UNICODE-строка переменной длины
tExtFile DT_EXTFILE Внешний файл

1)Типы данных call-интерфейса описаны в документе «СУБД ЛИНТЕР. Интерфейс нижнего уровня».