Руководство разработчика

Утилита vmxcl.exe

Программа vmxcl.exe предназначена для запуска исполняемого кода (ibx) с поддержкой пользовательского интерфейса. Среда выполнения создается с возможностью UI, что, в частности, позволяет использовать средства модуля FC.

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

vmxcl.exe <имя файла> [-<опции>] [<пользовательские параметры>]
<имя файла> Имя исполнимого файла (ibх).
<опции> Необязательный параметр. Дополнительные опции задаются буквами в одном параметре (например, -do):
  • d – Предпочитать папку конфигурации debug, если заданный путь к файлу ibх не является абсолютным. По умолчанию используется конфигурация release.
  • o – Разрешает вывод отладочных сообщений в консольное окно. При компиляции исполнимый кода также должна быть включена соответствующая опция.
  • a – Принудительная загрузка всех доступных модулей, а не только тех, что использует указанный ibх. Эта опция может потребоваться при запуске других ibx из исполнимого кода (прямом или косвенном).
  • w – При успешном завершении выполнения ibх выводится всплывающее окно с уведомлением.
  • e – Запуск с поднятием до администраторских прав (elevated). В Windows выше XP с включенным UAC будет выдано сообщение о запуске программы с правами администратора. Если текущий пользователь не является администратором, то будет показано окно входа под другим пользователем Windows.
<пользовательские параметры> Одна или несколько строк, которые будут переданы исполнимому коду в виде входных параметров. Поддерживаются два режима передачи параметров:
  1. Последовательное заполнение параметров типа СТРОКА.
  2. Заполнение первого параметра контейнерного типа с одномерным последовательным индексом и строковым типом элементов.
Первый способ удобнее при фиксированном количестве параметров, а второй – при передаче списков.

Пример:

vmxcl.exe ДиалоговаяФорма.ibx -oa

Замечание

Для запуска ibх без поддержки пользовательского интерфейса (в консольном режиме) используется утилита ippvmcl.exe.


См. также: