DDEApp, DDE Based Inter-process Communication (C#, C++)

This article discuss an inter-process communication protocol dedicated for sharing data and perform remote function call between applications.

Introduction

 

DDE Application (DDEApp) is a Dynamic Data Exchange (DDE) based inter-process communication protocol created to exchange data and perform functions call between applications.

Back in 2009, when I was still programming in Borland C++ Builder, I needed to find a solution to call function remotely between two applications. We had decided to make use of DDE for this purpose. Using VCL control in Borland, we managed to get DDE up within few days. However, soon we realized that existing DDE protocol was not able to fully meet our requirement.


About DDEApp

 

DDEApp a command line inter-process communication protocol implemented based on DDE. It contains a client and host class named as below.
C#
Borland C++
DDEApp Server
DDEAppServer
MDDEApp_Server
DDEApp Client
DDEAppClient
MDDEApp_Client

An overview of the classes is shown as below. DDEApp Client is designed to handle multiple clients.
Actual inter-process communication took place in DDE Server and Client class.

 

DDEApp Features

 

Hide low level settings from user

There are several parameters that need to be set correctly in DDE Server and Client class before two process can "talk" to each other using DDE. Client needs to know the server's setting upfront. User must figure out these settings either from code or documentation to establish DDE connection with Server.

DDEApp hide all DDE related parameters from user. User who use DDEApp did not need any knowledge with DDE. A standard sets of setting will be used for all DDEApp Server and Client instances. This means that all DDEApp Servers and Clients can communicate with each others.

Support multiple clients and servers

DDEApp Client and Server is designed to handle multiple clients and servers. A DDEApp Client can connect to multiple servers while a DDEApp Server is able to handle respond from multiple clients.

The diagram above shows that both Client A and C are connecting to more than 1 server while Server B have 3 clients connected to it. Besides, Server B also can be configure as Client to communicate with Server C at the same time being a server.


DDEApp Protocol

To ensure the correct message is passed between selected server and client, DDEApp implemented a command line message protocol which contains information of sender and receiver as below.

    <Source> <Dest> <Commands>
  • Source : Sender application's EXE name.
  • Dest: Receiver application's EXE name.
  • Commands: DDEApp commands
When using DDEApp class, we do not need to remember the command format. Encode and decode of the commands are done internally by DDEApp Client and Server class.
    A DDEApp Server is visible as virtual class to client application with list of registered functions and variables. Registered functions are accessible using FunctionCall() in DDEApp Client whereas registered variable are accessible from VariableRead() and VariableWrite() in DDEApp Client.

    Cross platform (C++ / C#)

    As an inter-process communication protocol, DDEApp allows application build from different platform (e.g. Borland Builder 5, Borland Builder 6, Visual C#) to communicate with each other. This is useful for mid to large scale projects when code conversion from one platform to another is time consuming and expensive.

    Standard functions 

    DDEApp Server included a list of common functions to remotely control the server's application.
    • Help
    • HideMainForm
    • RestoreWindow
    • MinimizeWindow
    • BringToFront
    • SetWindowPosition 

    Function lists

    The "Help" function shows above is an internal function created to return list of registered functions and variables from DDEApp Server. With this features, we are able to get most updated functions and variables list which may change from version to version. This is much better than any external documentation.

    Image below shows list of functions and variables in DDEApp Client terminal returned from a DDEApp enabled server application.




    Function call with error reporting

    All function call from DDEApp Client to DDEApp Server are made via FunctionCall(). Client will receive execution status upon completion of the functions. FunctionCall() is available in both synchronous and asynchronous version.

    Image below shows an example of DDEApp function call which return without error.
    Besides, it also shows additional info sent from DDEApp Server when executing function.

     This is another example shows failed function call which returned an error message.

    Variable Read / Write 

    Variable read or write are done in a similar way as function call except that variable are either read and write or just read only. Read or write to variable is synchronous call using VariableRead() and VariableWrite().

    Connect / Disconnect / Shut Down

    DDEApp Client can be connect or disconnect from DDEApp Server when required using function Connect() and Disconnect(). Server will get notify when a client is connected or disconnected.

    Besides, the client can request server to shut down using ShutDownServer() function. An OnClientShutdownQuery event will be raised at server application. Server has full authority to decide whether to proceed to shutdown itself.

    Online / Offline

    Online() and Offline() are two functions dedicated for DDEApp Server to enable or disable DDEApp protocol. When server is offline, none of the client is allowed to connect to the server. Any client that was connected earlier will received a OnLinkClosed event.


    DEMO and Tutorial


    NOTE:  DDE Application and C++ Library is compiled using Borland C++ Builder.
    If you were not able to run the executable file, pleas get the re-distributed library from below.


      Popular posts from this blog

      WinForms Gauge Control

      Image
      Introduction WinForm Gauge - Released 2021   WinForm Gauge is successor for AGauge control, redesigned with better structure, performance and features. Find out more  at https://winformgauge.codearteng.com/     Original AGauge control AGauge is a gauge control for WinForms create by A.J.Bauer using GDI+. Original code was published in " Code Project - A fast and performing gauge " The version that I published here is an improved version of AGauge which contains the following changes. Download from GitHub   NOTE: We no longer actively maintaining AGauge. The development of this package is taken over by nutdotnet . Refer to his GitHub and NuGet page for details.   Improvements   Dynamic Gauge Label and Gauge Range Properties for gauge label (previously known as CapText ) and range are grouped into GaugeRanges and GaugeLabels which allow us to create any number of range and label ...
      Read more

      WinForms Controls

      Image
      Description Collection of .NET Windows Forms controls for WinForms application. Named as CodeArtEng.Controls.dll Download GitHub NuGet Features  Command Line Helper Labeled Text Box Hinted Text Box Multi-Line Button Status Label Open File Panel and Folder Browse Panel MRU (Most Recent Used File List) File Explorer Control Quick Access List Rich Text Box Editor Features Description Command Macro Editor Input editing dialog inspired by Visual Studio "Edit Pre-Build" and "Edit Post-Build" Dialog... ( Learn More... ) Command Line Helper Generate and parse command line with command line helper. ( Learn More... ) Labeled Text Box  Text box with label and hint, derived from Hinted Text Box. Hinted Text Box  Enhanced version of WinForms TextBox with capability to show hint in gray color text. Multi-Line Button  Button control with optional image and 2 lines of text, main and sub title. Each line can be configured using d...
      Read more

      C# DSP Simulation - DSP Lab

      Image
      Introduction DSP Lab  is a digital signal processing simulation application created to simulate and visualize process of sampling and filtering analog signal using DSP system. This application is created to provide as a tool for educator and student to have a better understanding how DSP system works. DSP Lab allow you to view and listen to output from (Data Acquisition Unit) DAQ and digital filters. DSP Toolbox is the core of DSP Lab application which is a .NET assembly written in C#. The library is released under MIT license. You can use this library to jump start your own DSP powered application. DSP System DSP Lab is built using the system as shown above. Settings for each components are configurable. In PREMIUM  version, a 3 channels mixer system is available for more fun and signal combinations.
      Read more