ЛИНТЕР

Инициализация пути к БД

Назначение

Сохранение в управляющей структуре LINDBCtrl пути к БД с целью последующего его использования для запуска СУБД.

Синтаксис

L_LONG LINDBCtrlSetDbPath(t_LINDBCtrl* LINDBCtrl, char* DbPath);

Входные данные

Входными данными являются:

инициализированная управляющая структура LINDBCtrl;
путь к БД. Допустимые значения:
- строка длиной не более 1024 байт (должна заканчиваться двоичным нулем);
- NULL-значение.

Выходные данные

Выходными данными является управляющая структура LINDBCtrl.

В управляющей структуре будут возвращены:

Имя поля		Значение
DbPath		Путь к каталогу БД
RetStatus		Библиотечный код завершения
SysStatus		0

Описание

Функция сохраняет в специально выделенной области динамической памяти, указатель на которую размещается в управляющей структуре LINDBCtrl, заданный в аргументе DbPath путь к БД.

Если аргумент DbPath равен NULL, в качестве пути к БД используется текущий каталог.

Возвращаемые значения

Функция возвращает:

0 – нормальное завершение;
-1 – путь к БД не инициализирован.

Коды завершения

Код		Описание
E_LINCTRL_NOINIT		Управляющая структура LINDBCtrl не инициализирована
E_LINCTRL_NOMEM		Невозможность выделения динамической памяти для поля DbPath управляющей структуры

Пример

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "linctrl.h"
#include "exlib.h"

void  PrintError(t_LINDBCtrl *LINDBCtrl);

void  main()
  {
  t_LINDBCtrl LINDBCtrl;
  CHAR  LinterPath[]="/usr/linter";
  LONGINT Err;
  Err=LINDBCtrlInit(&LINDBCtrl,LinterPath);
  if (Err != NORMAL)
    PrintError(&LINDBCtrl);
  printf("Initialisation LINDBCtrl\n");
  Err= LINDBCtrlSetDbPath(&LINDBCtrl,NULL);
  if (Err != NORMAL)
    PrintError(&LINDBCtrl);
  printf("Set DBPath\n");
  printf("End Example\n");
  }