.. highlightlang:: us

.. index:: DdeExecute

.. _ddeexecute:

DdeExecute
==========

.. us.tag  DdeExecute NOTREADYENGLISH Changed413

:ref:`DdeExecute` executes a server macro.

.. function::  bool = DdeExecute(hConv, ssCommand)
    bool = DdeExecute(hConv, ssCommand, rsTimeout)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hConv

   *hConv* is the channel number (handle) which is used with other UniPlot DDE
   functions.

.. uparam:: ssCommand

   *ssCommand* is a command string, e.g.
   ``DdeExecute(hConv, "[OPEN(\"c:/map.dif/")]")``.

.. uparam:: rsTimeout

   Specifies the maximum length of time, in milliseconds, that UniPlot will wait
   for a response from the server application in a synchronous transaction. This
   parameter should be 0xFFFFFFFF for asynchronous transactions. The default
   value is 5000.

.. us.example

**Example**

In the following example Excel is used to convert a file. A DIF file (Data
Interchange Format) is converted and loaded into a UniPlot Editor.

.. include:: ../include/test_DdeExecute.ic

.. seealso::
   :ref:`overview-dde`,
   :ref:`system`,
   :ref:`DdeInitiate`,
   :ref:`DdeTerminate`,
   :ref:`DdeTerminateAll`,
   :ref:`DdePoke`,
   :ref:`DdeRequest`

:sub:`id-1484792`