.. role:: clio-deprecated
   :class: clio-flag clio-flag-deprecated


#####################
A3DAsmModelFileDelete
#####################

.. c:function:: A3DStatus A3DAsmModelFileDelete(A3DAsmModelFile *pModelFile)

   .. rst-class:: clio-flags
   
      :clio-deprecated:`deprecated`
   
   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DAsmModelFileDelete(:c:type:`~A3DAsmModelFile`\ \* **pModelFile**\ )
   
   Deletes the entire :c:type:`~A3DAsmModelFile` entity from memory.
   
   This function frees all the all memory allocated for ``pModelFile``\ . It recursively deletes all entities inside the model file, thus deleting the whole PRC tree. After the call, access to the model file is no longer possible, and ``pModelFile`` is invalid.
   
   
   .. warning::
   
      This function is deprecated. Please use :c:func:`~A3DEntityDelete` instead to implement the same behaviour. This will be removed in version 2028.1.0.
   
   
   **Return Values**
   
   
      **A3D_INVALID_ENTITY_NULL**\ :
   
      **A3D_INVALID_ENTITY_TYPE**\ :
   
      **A3D_SUCCESS**\ :
   
   
   
      This function is only applicable to a model file.
   
   
   
      This function must not be applied within an HOOPS Visualize context. See
   
   
      ::
   
         embed:rst:inline :doc:`/start/getting-started`
   
      .
   
   
   See :c:func:`~A3DEntityDelete` for a more generic approach.
   
   
      `Deleting a PRC tree <https://docs.techsoft3d.com/exchange/latest/guide/basic_operations/building_prc_7.html>`__
   
   
   
      2.0
   
   
   **Returns**
   
   
      ``A3D_SUCCESS`` on success, or an error code on failure
   
   




