
###################
A3DPDFWidgetGetName
###################

.. c:function:: A3DStatus A3DPDFWidgetGetName(A3DPDFWidget *pWidget, A3DUTF8Char **ppcWidgetId)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPDFWidgetGetName(:c:type:`~A3DPDFWidget`\ \* **pWidget**\ , :c:type:`~A3DUTF8Char`\ \*\* **ppcWidgetId**\ )
   
   Function to retrieve the name (identifier) of a widget.
   
   Widgets are fields or more high-level entities.
   
   
   Memory Management
   =================
   
   In case of success, ``ppcWidgetId``\ contains heap allocated memory you are responsible for. To free the memory on ``ppcWidgetId``\ , call ``A3DPDFWidgetGetName``\ with ``pWidget``\ set to *0*\ .
   
   
   **Parameters**
   
   
      **pWidget**\ : The Widget object to work with.
   
      **ppcWidgetId**\ : The identifier as a string.
   
   




