.. highlightlang:: us

.. index:: DS_SetValue

.. _ds_setvalue:

DS_SetValue
===========

.. us.tag DS_SetValue NOTREADYENGLISH DataSource New5200

:ref:`DS_SetValue` sets a value in the "Datasource" map.

.. function:: bool = DS_SetValue(hData, ssKey, value)

.. us.return

**Return Value**

Is TRUE (1), if the function was successful and otherwise FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the dataset handle.

.. uparam:: ssKey

   *ssKey* is the name of the key to be set.

.. uparam:: value

   *value* is the value to be set.

.. us.example

**Example**

::

   DS_SetValue(hData, "FirstPoint", 0);
   DS_SetValue(hData, "NumberOfPoints", 7200);
   XYReload(hData, XY_RELOAD_UPDATE);

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.20
     - New.

.. seealso::
   :ref:`overview-data-file-informations-for-datasets`,
   :ref:`DS_GetValue`,
   :ref:`DS_RemoveValue`

:sub:`id-630409`