Создание соединения – 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");