.. highlightlang:: us

.. _objdestroy:

ObjDestroy
==========

.. index:: ObjDestroy

.. us.tag  ObjDestroy ENGLISH

The :ref:`ObjDestroy` function destroys the given
object and frees any memory the object occupied.

.. function::  bool = ObjDestroy(handle)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: handle

   *handle* identifies the object to be destroyed.

.. seealso::
   :ref:`overview-objects`,
   :ref:`ObjCreate`

:sub:`id-1168492`