.. highlightlang:: us

.. index:: DdeRequest

.. _dderequest:

DdeRequest
==========

.. us.tag  DdeRequest NOTREADYENGLISH Changed413

:ref:`DdeRequest` retrieves data from a server.

.. function::  ssData = DdeRequest(hConv, ssTopic)
    ssData = DdeRequest(hConv, ssTopic, rsTimeout)

.. us.return

**Return Value**

*ssData* is a scalar string with the data.

.. us.params

**Parameters**

.. uparam:: hConv

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

.. uparam:: ssTopic

   *ssTopic* is the topic name.

.. 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.

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

:sub:`id-772360`