.. highlightlang:: us

.. index:: DocGetPathName

.. _docgetpathname:

DocGetPathName
==============

.. us.tag  DocGetPathName ENGLISH DocGet Changed5800

:ref:`DocGetPathName` returns the document file name or an empty string if the 
document has not been saved.

.. function::  ssPathName = DocGetPathName(hDoc)
               ssPathName = DocGetPathName(hDoc, bExtern)

.. us.return

**Return Value**

*ssPathName* is the document file name or an empty string if the document has not
been saved.

.. us.params

**Parameters**

.. uparam:: hDoc

   Identifies the document.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2016
     - New parameter *bExtern*.

.. seealso::
   :ref:`overview-documents`,
   :ref:`DocCreate`,
   :ref:`DocSetPathName`

:sub:`id-1547292`