====== zproj_CreateMap ======

===== Description =====

Create a new map layer in the application's project, and retrieve the handle. 

===== Files =====

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

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

<code="C">ZMAP zproj_CreateMap(const char* lpMapName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
|  //lpMapName//  |  const char*  | A handle to a C-style string containing the name or mnemonic for the new map layer. |

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

Null if:
  * The given //lpMapName// is already in use, or;
  * An unspecified error occurred (check the error log).
Otherwise, and a valid non-null ''ZMAP'' handle is returned.

===== Comments =====

None.