SysExec

From SunFlurry wiki
Jump to: navigation, search
  SysExec (Функции среды)
Объект:Функции общего назначения
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число
Визуальность:Нет

Функция производит запуск приложения с параметрами в командной строке, приложение может находиться на сервере, в этом случае, оно сначала будет перенесено на локальный диск. Данный способ исполнения может использоваться для визуальных приложений. Если путь к приложению указывает на серверные файлы (см. Имена файлов), функция сначала получает исполняемый файл с сервера и помещает его в локальную папку временных файлов, после чего производит его запуск из этой папки. Скачивание файла с сервера происходит только при необходимости (локальный файл отсутствует или устарел).

Синтаксис

SysExec(<Командная строка исполнения (STRING)>,<Не возвращаться до завершения (INT)>=0):<Код, возвращенный приложением (INT)>

Аргументы

  • <Командная строка исполнения (STRING)> - Строка с путем к приложению, его наименованием и параметрами исполнения, если необходимо. К примеру, C:\Windows\System32\NETSTAT.EXE -a -n
  • <Не возвращаться до завершения (INT)> - (необязательный аргумент) Аргумент задает режим ожидания окончания выполнения приложения. По умолчанию (0), функция не будет ожидать окончания выполнения приложения.

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

Возвращает целое число, зависящее от режима исполнения:

  • В режиме ожидания окончания исполнения приложения, число соответствует коду, который возвратило приложение при выходе.
  • В режиме, когда функция возвращается без ожидания окончания исполнения приложения, число соответствует коду ошибки операционной системы (0 -- приложение запущено без ошибок)


Примеры

//Исполняется файл C:\Executable.exe с указанными параметрами
SysExec("C:\Executable.exe /Switch1 /Switch2");