====== zmap_GetFilename ======

===== Description =====

Retrieve the full pathname of the file in which a given map has been saved (for example, ''C:\My maps\map1.hff'').

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

===== Function prototype =====

<code="C++">
const char* zmap_GetFilename(ZMAP hMap);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hMap//  |  ''ZMAP''  | A [[zeolite:types:ZMAP]] handle to a map variable, the saved filename of which is to be retrieved. |

===== Return value =====

A null pointer if the map has not yet been saved or an error occurred, and otherwise a valid non-null handle to a C-style string containing the full path of the file in which the map has been saved. 

If the map is a mosaic map, this function will return the filename of the mosaic master file (.mmf).

===== Comments =====

None.