
###################
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. 
   
   




