
#########################
A3DPDFViewGetExternalName
#########################

.. c:function:: A3DStatus A3DPDFViewGetExternalName(A3DPDFView *pView, A3DUTF8Char **ppcViewId)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPDFViewGetExternalName(:c:type:`~A3DPDFView`\ \* **pView**\ , :c:type:`~A3DUTF8Char`\ \*\* **ppcViewId**\ )
   
   Returns the identifier of the view.
   
   The identifier may be used by JavaScript or PDF actions to activate a view. It can also be used to generate poster. The function returns a string.
   
   
   Memory Management
   =================
   
   In case of success, ``ppcViewId``\ contains heap allocated memory you are responsible for. To free the memory on ``ppcViewId``\ , call ``A3DPDFViewGetExternalName``\ with ``pView``\ set to *0*\ .
   
   
   **Parameters**
   
   
      **pView**\ : The View object to work with. This object can be retrieved using the function :c:func:`~A3DPDF3DArtworkGetViews`
   
      **ppcViewId**\ : The identifier as a string.
   
   
   **Returns**
   
   
      A3D_SUCCESS in case of success or an error code
   
   




