
#################
A3DPrcIdMapCreate
#################

.. c:function:: A3DStatus A3DPrcIdMapCreate(A3DAsmModelFile *pA3DAsmModelFile, A3DPrcIdMap **ppPrcIdToEntityMapOut)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPrcIdMapCreate(:c:type:`~A3DAsmModelFile`\ \* **pA3DAsmModelFile**\ , :c:type:`~A3DPrcIdMap`\ \*\* **ppPrcIdToEntityMapOut**\ )
   
   Function to create a map linking PrcIds and A3DEntities.
   
   This function uses an :c:type:`~A3DAsmModelFile` entity to create a map linking PrcIds and instances of :c:type:`~A3DEntity`\ .
   
   **Return Values**
   
   
      **A3D_SUCCESS**\ :
   
   
   In case of success, ``ppPrcIdToEntityMapOut`` contains heap allocated memory you are responsible for. To free the memory on ``ppPrcIdToEntityMapOut``\ , call ``A3DPrcIdMapCreate`` with ``pA3DAsmModelFile`` set to *0*\ .
   
   
      13.0
   
   
   **Parameters**
   
   
      **pA3DAsmModelFile**\ : the modelFile used to create map.
   
      **ppPrcIdToEntityMapOut**\ : the map of prc ids to A3DEntity pointer.
   
   
   **Returns**
   
   
      A3D_SUCCESS in case of success or an error code
   
   




