
###############################
A3DMkpLinkForMarkupReferenceGet
###############################

.. c:function:: A3DStatus A3DMkpLinkForMarkupReferenceGet(const A3DMkpMarkup *pMarkup, A3DUns32 *puiLinkedItemsSize, A3DMiscMarkupLinkedItem ***ppLinkedItems)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DMkpLinkForMarkupReferenceGet(*const* :c:type:`~A3DMkpMarkup`\ \* **pMarkup**\ , :c:type:`~A3DUns32`\ \* **puiLinkedItemsSize**\ , :c:type:`~A3DMiscMarkupLinkedItem`\ \*\*\* **ppLinkedItems**\ )
   
   Get links corresponding to the :c:type:`~A3DMkpMarkup` references This function allocates and returns an array of :c:type:`~A3DMiscMarkupLinkedItem`\ .
   
   To free the allocated array, the function must be called again with pMarkup as NULL.
   
   
      6.0
   
   
   
      Internally there are several types of links such as reference, position, additional reference, owner or datum.This function only returns the reference links.
   
   
   **Return Values**
   
   
      **A3D_INITIALIZE_NOT_CALLED**\ :
   
      **A3D_INVALID_DATA_STRUCT_SIZE**\ :
   
      **A3D_INVALID_DATA_STRUCT_NULL**\ :
   
      **A3D_INVALID_ENTITY_NULL**\ :
   
      **A3D_INVALID_ENTITY_TYPE**\ :
   
      **A3D_SUCCESS**\ :
   
   
   **Parameters**
   
   
      **pMarkup**\ : The :c:type:`~A3DMkpMarkup` entity to get linked item list from. If NULL, pppLinkedItems is freed instead of being allocated.
   
      **puiLinkedItemsSize**\ : The number of :c:type:`~A3DMiscMarkupLinkedItem` in the resulting array.
   
      **ppLinkedItems**\ : The resulting array.
   
   
   **Returns**
   
   
      ``A3D_SUCCESS`` on success, or an error code on failure
   
   




