Приложение 2. Характеристики объектов LinAPI
Характеристики соединения, которые можно получить
| Характеристика | Тип данных | Описание | ||
|---|---|---|---|---|
cDBDesc
| L_WORD | Информация о БД, с которой связан ЛИНТЕР-сервер | ||
cNodeName
| L_CHAR(8) | Имя ЛИНТЕР-сервера | ||
cConnFlags
| L_LONG | Режимы работы по соединению (транзакции и кодировки) | ||
cChannelID
| L_LONG | Идентификатор соединения |
Характеристики соединения/курсора, которые можно получить/установить
| Характеристика | Тип данных | Свойство | Описание | |||
|---|---|---|---|---|---|---|
cPriority
| L_LONG | R/W | Приоритет соединения | |||
cApiCode
| L_LONG | R | Код сообщения LinAPI | |||
cLinCode
| L_LONG | R | Код завершения СУБД ЛИНТЕР последней операции по соединению | |||
cSysCode
| L_LONG | R | Код сообщения ОС, сопровождающий код завершения СУБД ЛИНТЕР | |||
cStrNumber
| L_LONG | R | Номер строки запроса, где встречена ошибка трансляции | |||
cPosNumber
| L_LONG | R | Номер позиции в строке запроса, где встречена ошибка трансляции | |||
cTransMode
| L_LONG | R | Режим обработки транзакций соединения | |||
cWaitComplete
| L_BOOL | W | Ждать/не ждать завершения асинхронной операции | |||
cWaitTimeout
| L_LONG | W | Длительность ожидания завершения асинхронной операции | |||
cUserData
| void * | R/W | Пользовательское значение параметра асинхронной функции |
Характеристики курсора, которые можно получить/установить
| Характеристика | Тип данных | Свойство | Описание | |||
|---|---|---|---|---|---|---|
cSelectRowCount
| L_LONG | R | Число записей в выборке данных | |||
cRowCount
| L_LONG | R | Количество записей, обработанных последним SQL-оператором | |||
cColumnCount
| L_LONG | R | Количество столбцов в выборке данных | |||
cStmtType
| L_LONG | R | Тип последнего выполненного оператора (см. Идентификаторы операторов) | |||
cCurrentRow
| L_LONG | R | Номер текущей записи в выборке данных | |||
cCurrentRowID
| L_LONG | R |
ПримечаниеХарактеристика устарела, использовать не рекомендуется. | |||
cExecStmt
| L_LONG | R | Количество выполненных (за один вызов Execute) операторов | |||
cExecRow
| L_LONG | R | Количество обработанных (за один вызов Execute) записей | |||
cAnswerDesc
| структура t_ParamDesc | R | Описание столбца выборки данных | |||
cAnswerSize
| L_LONG | R | Размер записи выборки данных (в байтах) | |||
cStmtNumber
| L_LONG | R | Номер текущего оператора | |||
cParamNumber
| L_LONG | R | Номер параметра, при обработке которого произошла ошибка | |||
cPriority
| L_LONG | R/W | Приоритет курсора | |||
cConnectID
| L_LONG | R | Номер соединения, по которому открыт курсор | |||
cTransMode
| L_LONG | R | Режим обработки транзакций курсора | |||
cApiCode
| L_LONG | R | Код завершения LinAPI | |||
cLinCode
| L_LONG | R | Код завершения СУБД ЛИНТЕР последней операции по курсору | |||
cSysCode
| L_LONG | R | Код завершения ОС, детализирующий код завершения СУБД ЛИНТЕР | |||
cStrNumber
| L_LONG | R | Номер строки запроса, где встречена ошибка трансляции | |||
cPosNumber
| L_LONG | R | Номер позиции в строке запроса, где встречена ошибка трансляции | |||
cCursorName
| L_CHAR(66) | R/W | Имя курсора | |||
cNullIndicator
| L_LONG | R | Признак NULL-значения | |||
cIsAutoInc
| L_LONG | R | Признак AUTOINC-значения | |||
cProcErrNum
| L_LONG | R/W | Количество ошибок при трансляции процедуры | |||
cProcArgNum
| L_LONG | R | Количество аргументов в процедуре | |||
cProcArgDesc
| структура ARGPROC_OUT | R | Описание аргумента процедуры | |||
cProcArgName
| L_CHAR(66) | R | Имя аргумента процедуры | |||
cProcCursorArg
| L_LONG | R | 1 – если параметр является курсором, 0 – в противном случае | |||
cWaitComplete
| L_BOOL | W | Ждать/не ждать завершения асинхронной операции | |||
cBlobLength
| L_LONG | R | Длина BLOB-данных | |||
cBlobType
| L_LONG | R | Тип BLOB-данных | |||
cWaitTimeout
| L_LONG | W | Длительность ожидания завершения асинхронной операции | |||
cUserData
| void * | R/W | Пользовательское значение параметра асинхронной функции | |||
cIsUpdatable
| L_LONG | R | Курсорная выборка данных обновляемая | |||
cIsInCallback
| L_LONG | R | Признак наличия функции обратного вызова |
Характеристики оператора, которые можно получить/установить
| Тип характеристики | Тип данных | Свойство | Описание | |||
|---|---|---|---|---|---|---|
sParamCount
| L_LONG | R | Число параметров в операторе | |||
sAnswerDesc
| структура t_ParamDesc | R | Описание столбца выборки данных | |||
sColumnCount
| L_LONG | R | Число столбцов в выборке данных | |||
sParamDesc
| структура t_ParamDesc | R | Описание параметра | |||
sConnectID
| L_LONG | R | Идентификатор соединения, по которому создан оператор | |||
sApiCode
| L_LONG | R | Код завершения LinAPI | |||
sIsAutoInc
| L_LONG | R | Признак AUTOINC-значения | |||
sStmtType
| L_LONG | R | Идентификатор типа оператора (см. Идентификаторы операторов) | |||
sParamType
| L_LONG | R | Тип параметра (pInput, pOutput, pInputOutput) | |||
sParamMap
| L_LONG | R | Порядковый номер столбца для параметра в выборке данных | |||
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-интерфейса описаны в документе «СУБД ЛИНТЕР. Интерфейс нижнего уровня», приложение 3 «Типы данных интерфейса нижнего уровня».