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


######################
A3DDllActivateXMLTrace
######################

.. c:function:: A3DVoid A3DDllActivateXMLTrace(A3DBool activate)

   .. rst-class:: clio-flags
   
      :clio-deprecated:`deprecated`
   
   .. rst-class:: sig-pretty-signature
   
      | :c:type:`~A3DVoid` A3DDllActivateXMLTrace(:c:type:`~A3DBool` **activate**\ )
   
   
   .. warning::
   
      This function was deprecated in HOOPS Exchange 2026.1.0. This will be removed in version 2028.1.0. This function activates an XML trace file that lists the PRC entities contained in a modelfile built during a Load session or written during an export to PRC session. A load session is done with following functions :``A3DAsmModelFileLoadFromFile``\ , :c:func:`~A3DAsmModelFileLoadFromMultiplePrcFile`\ , ``A3DAsmModelFileLoadFromPrcFile``\ , and ``A3DAsmModelFileLoadFromPrcStream``\ . An export session is done with following functions :``A3DAsmModelFileExportToPrcFile``\ . To activate an XML trace, call this function BEFORE calling any of these functions.
   
   
   
      2.0
   
   
   
      This function may slow down your process. Use XML trace only for debugging.
   
   
   
      The XML file produced by this feature can be very large.
   
   
   
      XML trace file is created in the same folder as the filename provided to the studied function.
   
   
   
      Because this function does not return :c:enum:`~A3DStatus`\ the internal thread safety policy is to wait for the availability of the API.
   
   




