Документация на dde сервер
вариант lite
Luxidsoft 2010
Ограничения
по сравнению с полной версией dde.exe:
Исполняемый модуль dde_lite.exe предназначен для вывода поступающих по dde данных в стандартный поток вывода.
1. При запуске исполняемого модуля dde_lite.exe в качестве параметра командной строки можно указать выражение
/?
В результате чего будет выведено окно с описанием типа и версии программы. После закрытия окна приложение завершит свою работу.
2. Если в системе уже имеется запущенный dde_lite.exe, то последующие попытке стартовать копию приложения будут проигнорированы.
3. Обязательным условием работы приложения является наличие в каталоге запуска dde_lite.exe файла dde.wsc. Данный файл представляет собой скриптовый COM объект со следующими методами:
a.
StartEXE(path, cmdline,params)
Этот метод выполняется при старте приложения. Параметрами ему служат:
path – каталог запуска приложения dde_lite.exe
cmdline – командная строка запуска приложения dde_lite.exe
params – скриптовый объект, служащий для инициализации работы приложения
данный метод возвращает целое значение, в случае если оно меньше нуля, то приложение завершает работу.
b.
ErrorEXE(errordescription)
Метод выполняется в случае ошибки
в приложении, после этого приложение завершает свою работу. Параметры:
errordescription – текстовое описание ошибки
c.
StopEXE()
Метод выполняется при нормальном завершении работы приложения.
4. Через параметр params метода StartEXE можно указать начальные параметры работы dde_lite.exe. По смыслу это схоже с работой ini фалов.
Существует возможность указать следующие параметры:
Наименование |
Тип |
Обязательность |
Описание |
Пример |
servername |
Не пустая строка |
Да |
Задает имя
dde сервера,
куда надо отправлять данные для обработки приложением. |
excel |
pipe_app |
Не пустая строка |
Да |
Может быть
заполнено значением self – в этом
случае данные будут передаваться в стандартный поток вывода, иначе необходимо
указать путь к приложению, которое будет запущено и в стандартный потока
ввода которого будет направлены данные. |
self out.exe |
pipe_size |
Не
отрицательное целое |
Нет,
только если в качестве параметра pipe_app
указано стороннее приложение |
Размер
потока вывода для передачи данных. Если задать этому параметру значение 0, то
размер потока будет определяться операционной системой. |
1000 |
rows_num |
Не
отрицательное целое |
Да |
Задает
число первых строк таблицы, которые будут выводиться в поток вывода. Если
задать этому параметру значение 0, то выводиться будут все строки таблицы |
12 |
EOL |
Не пустая
строка |
Нет |
Разделяет
строки, выводимые в поток. Если параметр не задан, то по умолчанию в качестве
разделителя используется два символа с ASCII кодами 13 и 10 |
Chr(21) |
5. В случае если параметр pipe_app не равен self, то при старте dde_lite.exe стартует дочерний процесс, указанный в этом параметре, который связан с родительским процессом через поток.
6. Формат вывода данных в поток вывода следующий:
[<topic>]<item><знак равно><value(1,1)>chr(1)<value(1,2)>chr(1) …<value(n,m)><EOL>
Где
<topic>,
<item> - значения
настроек для DDE
<value(i,j)> - значение таблицы в i-м ряду и j-м столбце
chr(1) – символ с ASCII кодом 1
<EOL> - значение настроек из StartEXE
Пример строки:
[TVS]1=1.02 chr(1) Сбербанк chr(1) 2 chr(13)
chr(10)
7. В случае возникновения ошибки в
процессе работы будет вызван метод ErrorEXE скриптового
объекта dde.wsc, после
чего приложение завершит свою работу. Причину ошибки можно узнать через
параметр errordescription метода
ErrorEXE .
8. Для завершения работы приложения необходимо
запустить исполняемый модуль exit.exe, а в качестве параметра командной строки указать имя dde сервера, который необходимо
остановить.
Пример:
dde.exe
excel
9. При корректном завершении приложения вызывается метод StopEXE скриптового объекта dde.wsc.
Пример запуска
dde.exe > TEST.TXT