Создание соединения – LINTER_ConnectCSEx/ LINTER_ConnectCS/ LINTER_Connect
Прототипы функций
L_LONG LINTER_ConnectCSEx( L_CHAR *UserName, /* имя пользователя */ L_SWORD NameLen, /* длина имени пользователя */ L_CHAR *PassWord, /* пароль пользователя */ L_SWORD PassLen, /* длина пароля пользователя */ L_CHAR *ServerName, /* имя ЛИНТЕР-сервера */ L_CHAR *CharSet, /* имя кодовой страницы */ L_LONG Mode, /* режим работы соединения */ L_WORD *ConnectionID, /* идентификатор соединения */ L_LONG *plApiError, /* код завершения LinAPI */ L_LONG *plLinError, /* код завершения СУБД ЛИНТЕР */ L_LONG *plSysError); /* код завершения ОС */
Устаревшие варианты:
L_LONG LINTER_ConnectCS( L_CHAR *UserName, /* имя пользователя */ L_SWORD NameLen, /* длина имени пользователя */ L_CHAR *PassWord, /* пароль пользователя */ L_SWORD PassLen, /* длина пароля пользователя */ L_CHAR *ServerName, /* имя ЛИНТЕР-сервера */ L_CHAR *CharSet, /* имя кодовой страницы */ L_LONG Mode, /* режим работы соединения */ L_WORD *ConnectionID); /* идентификатор соединения */ L_LONG LINTER_Connect( L_CHAR *UserName, /* имя пользователя */ L_SWORD NameLen, /* длина имени пользователя */ L_CHAR *PassWord, /* пароль пользователя */ L_SWORD PassLen, /* длина пароля пользователя */ L_CHAR *ServerName, /* имя ЛИНТЕР-сервера */ L_LONG Mode, /* режим работы соединения */ L_WORD *ConnectionID); /* идентификатор соединения */
Входные параметры
Параметр | Описание | |
---|---|---|
UserName
| Имя пользователя | |
NameLen
| Длина имени пользователя | |
Password
| Пароль пользователя (может иметь значение NULL) | |
PassLen
| Длина пароля пользователя | |
ServerName
| Имя ЛИНТЕР-сервера (может иметь значение NULL для использования сервера по умолчанию) | |
CharSet
| Имя кодовой страницы | |
Mode
| Режим работы соединения |
Режимы соединения (определены в заголовочном файле linapi.h
):
-
mAutocommit – режим транзакций AUTOCOMMIT;
-
mOptimistic – режим транзакций OPTIMISTIC;
Примечание
Режим OPTIMISTIC устарел (использовать не рекомендуется).
-
mExclusive – режим транзакций PESSIMISTIC;
-
mAnsi – канал работает в кодировке ANSI;
-
mKoi8 – канал работает в кодировке KOI8.
Выходные параметры
Параметр | Описание | |
---|---|---|
ConnectID
| Идентификатор созданного соединения | |
Mode
| Установленный режим работы соединения | |
plApiError
| Код завершения LinAPI-интерфейса | |
plLinError
| Код завершения СУБД ЛИНТЕР | |
plSysError
| Код завершения ОС |
Описание
Функции устанавливают соединение c ЛИНТЕР-сервером с именем ServerName
для пользователя UserName
с паролем PassWord
. Одновременно может быть открыто несколько соединений.
В поле UserName
возможно указание имени пользователя и, одновременно, пароля через косую черту (USERNAME/PASSWORD). Соединение будет иметь режим обработки транзакций равный MODE.
Если имена пользователей и их пароли не обрамлены двойными кавычками, то их значения приводятся к верхнему регистру, иначе передаются ядру СУБД ЛИНТЕР как есть, например,
пользователь: "\"Вася\""
пароль: \"Пупкин\"
Режимы обработки транзакций можно задавать одновременно с указанием режима кодировки записей выборки данных.
Функция LINTER_ConnectCSEx возвращают коды завершения в выходных параметрах, а для получения кодов завершения функций LINTER_Connect и LINTER_ConnectCS необходимо после их выполнения вызывать дополнительно функцию LINTER_GetError.
Пример
long lError; short nConnID; … If (lError =LINTER_Connect("system", 0, "manager", 0, NULL, mOptimistic, &nConnID)) processing_error(lError, nConnID, 0, 0, "LINTER_Connect");