JS+
Усиленный язык сценариев для Windows
с возможностью встраивания
в ваши приложения
О языке JS+ Справочник Скачать JS+ DLL
Контакты
СПРАВОЧНИК ПО ЯЗЫКУ JS+ Содержание

JSP_Start

- функция JS+ DLL
Функции JS+ DLL
Инициализирует библиотеку JS+ DLL для дальнейшей работы с приложением.
Синтаксис
int __stdcall JSP_Start(
  key_cStr,
  prm_cStr
);

Параметры
Параметр Тип Описание
key_cStr char* ключ пользователя библиотеки JS+ DLL или "TRIAL" для пробного использования (см. далее Примечание)
prm_cStr char* параметры вызова функции (см. ниже)

Параметр prm_cStr
Текстовая строка, содержащая параметры вызова функции вида:
"Prm1=Val1&Prm2=Val2&...".
На данный момент доступен параметр User, описывающий компилятор приложения, связанного с библиотекой JS+ DLL. Указание этого параметра необходимо для работы ряда функций библиотеки JS+ DLL, например, использующих выделение памяти под строковые объекты. Ниже приведены возможные значения параметра User:

Значение Описание
BC++ компилятор семейства C++ Builder
VC++ компилятор семейства Visual C++
Delphi компилятор семейства Delphi

Строка параметров является регистронезависимой, т.е. записи "User=Delphi" и "USER=DELPHI" являются эквивалентными.

В приложениях C++ Builder параметр User можно не указывать, поскольку значение User=BC++ принято по умолчанию.

Возвращаемое значение
Значение Описание
JSP_OK успешный вызов функции
JSP_BADTRL просроченный ключ пробного использования библиотеки JS+ DLL
JSP_BADKEY неверный ключ пользователя библиотеки JS+ DLL
JSP_ERROR внутренняя ошибка JS+ DLL
Пример (C++ Builder)
------------------------
 Приложение C++ Builder
------------------------

int ret;
AnsiString err_aStr;

if ((ret=JSP_Start("TRIAL",""))!=JSP_OK) {
  switch (ret) {
    case JSP_ERROR : err_aStr="internal error"; break;
    case JSP_BADTRL: err_aStr="bad trial key"; break;
    case JSP_BADKEY: err_aStr="bad user key"; break;
            default: err_aStr="error "+IntToStr(ret);
  }
  ShowMessage("JSP_Start: "+err_aStr);
  return;
}

// Успешное продолжение
Пример (Visual C++)
------------------------
 Приложение Visual C++
------------------------

int ret;
CString err_cStr;

if ((ret=JSP_Start("TRIAL","User=VC++"))!=JSP_OK) {
  switch (ret) {
    case JSP_ERROR : err_cStr="JSP_ERROR"; break;
    case JSP_BADTRL: err_cStr="JSP_BADTRL"; break;
    case JSP_BADKEY: err_cStr="JSP_BADKEY"; break;
            default: err_cStr="error "+ret;

  }
  AfxMessageBox(L"JSP_Start: "+err_cStr);
  return;
}

// Успешное продолжение
Пример (Delphi)
------------------------
 Приложение Delphi
------------------------

var
  ret:integer;
  err_Str:string;

begin
  ret:=JSP_Start('TRIAL','User=Delphi');
  if (ret<>JSP_OK) then
  begin
    case (ret) of
      JSP_ERROR : err_Str:='internal error';
      JSP_BADTRL: err_Str:='bad trial key';
      JSP_BADKEY: err_Str:='bad user key';
             else err_Str:='error '+IntToStr(ret);
    end;
    ShowMessage('JSP_Start: '+err_Str);
    Exit;
  end;
end;

// Успешное продолжение
Примечание
Пробное использование библиотеки JS+ DLL ограничено одним календарным месяцем с момента установки языка JS+. По истечении этого срока необходимо приобрести лицензионный ключ пользователя библиотеки JS+ DLL либо прекратить ее использование. При этом выполнение скриптов JS+ в рамках исполнительной системы JS+ или приложения JS+ Expert остается бесплатным и бессрочным.
Лицензионный ключ пользователя библиотеки JS+ DLL
Если вы решили использовать библиотеку JS+ DLL за пределами пробного периода, вам необходимо приобрести лицензионный ключ пользователя библиотеки JS+ DLL. Лицензионный ключ приобретается однократно, имеет бессрочный период действия и может быть применен к неограниченному кругу ваших приложений, распространяемых среди любого количества пользователей.
Купить лицензионный ключ пользователя JS+ DLL на официальном сайте JS+:

 www.jsplus.ru/jsp_dll.htm


Совместимость
C++ Builder/Delphi/Visual C++
JS+Руководство пользователя
Адрес этой страницы: http://jsplus.ru/MANUAL/JSPlus/EmbedApp/Function/JSP_Start.htm
© 2024,